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SUMMARY OF CHANGES 


This update to the first edition of the CTIX Operating System 
Manual, Version B documents the new commands and features of 
the 5.10 release of the CTIX operating system. Changes to the 
manual are summarized below. 


Volume 1 
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Revised frontmatter 
New or revised UUCP pages: 


uucheck(1M), uucleanup(1M), wucp(1C), uugetty(1M), 
uulog(1C), uuname(1C), uusched(1M), wustat(1C), uuz(1C), 
uzgt(1M), Uutry(1M). 

Other new pages: 

conftg(1M), fstze(1M), mktunedrv(1M), rmset(1M). 

Other revised pages: 

acctsh(1M), as(1), catman(1), cce({1), crash(1M), csh(1), 
ct(1), ctinstall(1), cu(1), daff(1), feck(1M), fsplit(1), hinv(1), 
tv(1), Ipset(1M), mkiftle(1M), mktpy(1), mount(1M), 
Ideeprom(1M), netman(1NM), netstat(1N), newform(1), 
news(1), nice(1), nroff(1), rep(1), rereed(1NM), rlogin(1N), 
route(1NM), rshd(1NM), ruptime(1N), rwho(1N), 
rwhod(1NM), sadp(1M), sar(1), sdp(1), setuname(1M), 
setuname(1), stty(1), tar(1), telnet(1N), telnetd(1NM), 
troff(1), voleopy(1M), zmset(1M). 

Deleted pages: 


uuclean(1M). 
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Volume 2 

e Revised frontmatter 

e New pages: 
open(2), Dialers(5), Devices(5), vt(7). 

e Revised pages: 
intro(2), bind(2N), connect(2N), exec(2), toctl(2), 
listen(2N), mount(2), mount(2), pipe(2), ptrace(2), 
setpgrp(2), stgnal(2), socket(2N), curses(3), dial(3C), 
getgrent(3C), gethostent(3N), gethostname(3N), 
getnetent(3N), getprotoent(3N), getservent(3N), lockf(3C), 
nlist(3C), ocurse(3X), remd(3N), rerec(3N), tssue(4), 
protocols(4N), terminfo(4), system(4), fentl(5), intro(7), 
console(7), disk(7)}, drivers(7). 


e Deleted pages: 
modemcap(5). 
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GUIDE TO TECHNICAL DOCUMENTATION 





This manual is one of a set that documents the Convergent 
Family of CTIX Operating Systems. The set can be grouped as 
follows: 


Hardware 
MegaFrame 
MegaFrame Diagnostics Manual 
MegaFrame Hardware Manual 
Quarter-Inch Cartridge Tape Upgrade Installation for 
MegaFrame Manual 
MightyFrame 
MightyFrame Diagnostics Manual 
MightyFrame Installation Manual 
MiniF'rame 
MiniFrame Diagnostics Manual 
MiniFrame Plus Hardware Manual 
MiniFrame Plus Installation Manual 


Operating Systems 
CTIX Operating System Manual 
CTIX Operating System Manual, Version B 
MegaFrame CTIX Operating System Manual 


System Administration 
CTIX Administration Tools Manual 
MegaFrame CTIX Administrator’s Manual 
MightyFrame Administrator’s Reference Manual 
MintFrame Administrator’s Manual 


Program Development 
CTIX Programmer’s Guide 
Writing MightyFrame Device Drivers 


Communications and Networks 
CTIX Internetworking Manual 
CTIX SNA 8270 Terminal Emulator Manual 
CTIX SNA Network Gateway Manual 


The following section outlines the contents of these manuals. 
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HARDWARE 
MegaFrame 


The MegaFrame Diagnostics Manual contains diagnostic tests for 
the MegaFrame processor boards, disk and cartridge controllers, 
and utility programs. 


The MegaFrame Hardware Manual contains the theory of 
operation and architecture for all the boards used in the 
MegaFrame. In addition, the Quarter-Inch Cartridge Interface 
board is described. 


The Quarter-Inch Cartridge Tape Upgrade Installation for 
MegaFrame Manual describes the quarter-inch cartridge tape 
upgrade installation prerequisites and procedures for the 
MegaFrame. 


MightyFrame 


The MightyFrame Diagnostics Manual tells how to execute 
MightyFrame diagnostic tests to ensure proper computer 
operation or to identify a malfunction. 


The MightyFrame Installation Manual tells how to install the 
MightyFrame computer, its expansion cards, hard disk drives, 
and terminals. The manual provides an overview of the 
computer and its components. Detailed instructions are given for 
setting up the MightyFrame, installing expansion cards and hard 
disk drives, connecting terminals, and powering it on. 


MiniFrame 


The MiniFrame Diagnostics Manual describes how to load and 
run diagnostics, and details diagnostic tests and errors for the 
MiniFrame. 


The MiniFrame Plus Hardware Manual gives the functional 
description, interface parameters, programming information, and 
circuit description for the MiniFrame Plus. In addition, the 
Quarter-Inch Cartridge Interface board is described. 


The MiniFrame Plus Installation Manual details the MiniFrame 
Plus installation, system configurations and expansions, and 
maintenance. 


5/86 -vi- 


OPERATING SYSTEMS 


The CTIX Operating System Manual, CTIX Operating System 
Manual, Version B, and the MegaFrame CTIX Operating System 
Manual describe the CTIX operating system, an operating system 
derived from the UNIX System V operating system, Each 
manual describes the system on one of the MiniFrame, 
MegaFrame, or MightyFrame systems. Each manual describes 
CTIX commands, application programs, system calls, library 
subroutines, special files, file formats, games, miscellaneous 
facilities, and system maintenance procedures. These manuals 
are the starting point for detailed information about CTIX 
features. 


SYSTEM ADMINISTRATION 


The CTIX Administration Tools Manual introduces the principles 
of CTIX system administration. The manual is useful for both 
system administrators and nonprivileged users: it describes tools 
used to automate certain system administration responsibilities, 
as well as management functions the nonprivileged user can 
perform on his own account. When the manual is used in 
conjunction with the appropriate administrator’s manual, the 
reader has a complete set of administration instructions. 


The MightyFrame Administrator’s Reference Manual defines the 
responsibilities of a MightyFrame system administrator and 
provides procedures for the administrator to follow. The manual 
explains the concepts an administrator must understand to 
maintain the proper functioning of a MightyFrame system, 
including: user support; CTIX modes; CTIX file systems; 
peripheral devices; and troubleshooting. 


The MegaFrame CTIX Administrator’s Manual explains the 
concepts an administrator must understand to maintain the 
CTIX operating system on a MegaFrame computer system. The 
manual documents certain files, such as minor devices, that 
reside in the CTOS file system. 


The MintFrame Administrator’s Manual is a guide for CTIX 
system administrators for the MiniFrame computer system. 
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PROGRAM DEVELOPMENT 


The CTIX Programmer’s Guide addresses the programmer’s need 
for detailed explanations about the CTIX operating system. The 
guide discusses major tools, including basic interaction with the 
operating system, source code control, calculator languages, text 
editing, and C programming. The guide is used in conjunction 
with the CTIX Operating System Manual. 


Writing MightyFrame Device Drivers is a tutorial and reference 
manual for the experienced C programmer. It describes 
MightyFrame architecture, the OTIX kernel, and _ other 
information about developing device drivers, along with sample 
programs. 


COMMUNICATIONS AND NETWORKS 


The CTIX Internetworking Manual is both a tutorial and 
reference guide for users and programmers. The manual 
describes CTIX internetworking concepts, how to use network 
commands of the CTIX operating system, and how to set up and 
manage a network. CTIX internetworking is a_ protocol- 
independent system that is compatible with many protocols and 
media (e.g., TCP/IP, uucp, and Ethernet). 


The CTIX SNA 8270 Terminal Emulator Manual outlines the 
features and functions of the SNA 3270 Terminal Emulator for 
the CTIX operating system. The manual provides detailed 
instructions for using, installing, configuring, and troubleshooting 
the Emulator software. 


The CTIX SNA Network Gateway Manual provides technical 
information and operating procedures for the installation, 
configuration, operation, and maintenance of a CTIX SNA 
Network Gateway. The manual also defines IBM SNA general 
concepts and describes the Gateway components. 
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SUGGESTED READING 





The following books are just a few of the many books available 
that provide useful information about the UNIX operating 
system and how to use it most effectively. If you are a CTIX 
user or a © programmer, you will want to select one of these 
books or others to have on hand. 


Bourne, S.R. The UNIX System. London: Addison-Wesley, 
1983. 


Kernighan, Brian W.; Dennis M. Ritchie. The C’ Programming 
Language. Englewood Cliffs, N.J.: Prentice-Hall, 
1978. 


Kernighan, Brian W.; P. J. Plauger. Software Tools. Reading, 
Mass.: Addison-Wesley, 1976. 


Kernighan, Brian W.; Rob Pike. The UNIX Programming 
Environment. Englewood Cliffs, N.J.: Prentice-Hall, 
1984. 


McGilton, Henry; Rachel Morgan. Introducing the UNIX System. 
New York: McGraw-Hill, 1983. 


Sobell, Mark G. A Practical Guide to the UNIX System. Menlo 
Park, Calif.: Benjamin/Cummings, 1984. 


Thomas, Rebecca; Lawrence R. Rogers; Jean L. Yates. Advanced 
Programmer’s Guide to UNIX System V. Berkeley, 
Calif.: Osborne McGraw-Hill, 1986. 
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HOW TO USE THIS MANUAL 





The CTIX Operating System Manual, Version B, describes the 
commands, system calls, libraries, data files, and device 
interfaces that make up the CTIX Operating System on 
MiniFrame Computer Systems and MightyFrame Computer 
Systems. Only internal-use and unbundled software products are 
excluded. This manual should always be your starting point 
when you need to find the documentation for a CTIX feature 
with which you are unfamiliar. 


The manual consists of a large number of short entries, 
sometimes called “the man pages,” after the command which 
accesses the entries when they are kept online. Each entry 
briefly documents some feature of CTIX. Some features require 
longer documentation than an entry in this manual; such features 
have an entry that outlines the feature and cross-references the 
manual that documents the feature fully. Entries that do not 
refer to other manuals are self-contained and are the final word 
on the features they describe. 


Organization of the manual. The entries are organized into 
seven sections in two volumes: 


Volume 1: 
1. Commands and Application Programs. 


Volume 2: 

System Calls. 

Subroutines and Libraries. 
File Formats. 
Miscellaneous Facilities. 
Games. 

Special files. 


ND OR go 09 


Within each section, entries are alphabetical by title, except for 
an intro entry at the beginning of each section. 


Entry Title Conventions. An entry title looks like this 
example: 


erf(3M) 


ntry Type 
ection Number 


ame 
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Name is the name of the entry. Section Number indicates the 
section that contains the entry. In this case, the entry is in 
Section 3, which is in Volume 2. Entry Type is only on entries 
that belong to special categories; refer to the section’s tntro entry 
for an explanation. In this case, a reference to intro(3) would tell 
you that erf(3M) describes functions from the Math Library, 
which the C compiler does not load by default. 


Finding the entry you need. To find out which entry you 
need, refer to the following guides: 


° The Permuted Index. This indexes each significant word 
in each entry’s description. It is useful when you only 
have a general notion what you’re looking for. It is also 
useful when you know the name of the command, 
function, etc., that you are interested in, but there is no 
entry by that name. To simplify its use, a complete 
Permuted Index for both volumes is in each volume. 


° The Table of Contents. This is a simple list of entries, 
by section, together with the entry descriptions. Volume 
1 has a Table of Contents for Section 1. Volume 2 has a 
Table of Contents for Sections 2 through 7. 


e The Table of Related Entries. For Volume 1 only. A 
table of entries organized so that related entries are 
grouped together. 


Section organization. Each section begins with an intro entry, 
which provides important general information for that section. 


Section 1, Commands and Application Programs, describes 
programs intended to be invoked directly by the user or by 
command language procedures, as opposed to subroutines, which 
are intended to be called by the user’s programs. Commands 
generally reside in the directory /bin (for binary programs). 
Some programs also reside in /usr/bin, to save space in /bin. 
These directories are searched automatically by the command 
interpreter called the shell, Commands that were not 
transported from UNIX System V reside in /usr/local/bin; this 
directory is recommended for locally implemented programs. 
Some administrative commands reside in /ete and various other 
places. The /ete directory is searched automatically if you are 
logged in as root; otherwise type out the full path name given 
under SYNOPSIS or change the PATH environment variable to 
include the command’s directory. 


Section 2, System Calls, describes the entries into the CTIX 
kernel, including the C language interfaces. 
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HOW TO GET STARTED 





This discussion provides the basic information you need to get 
started on CTIX: how to log in and log out, how to communicate 
through your terminal, and how to run a program. (See the 
CTIX Programmer’s Gutde for a more complete introduction to 
the system.) 


Logging in. Most MightyFrame and MiniFrame terminals are 
either cluster or 9600 baud asynchronous terminals. An unused 
terminal prompts login:. 


Most asynchronous terminals have a speed switch that should be 
set to the appropriate speed and a half-/full-duplex switch that 
should be set to full-duplex. When a connection (at the speed of 
the terminal) has been established, the system types login: and 
you then type your user name followed by the “return” key. If 
you have a password (and you should!), the system asks for it, 
but does not print (‘“echo’’) it on the terminal. After you have 
logged in, the “return”, ‘‘new-line”, and “‘line-feed’”’ keys will 
give exactly the same result. 


It is important that you type your login name in lower case if 
possible; if you type upper-case letters, CTIX will assume that 
your terminal cannot generate lower-case letters and that you 
mean all subsequent upper-case input to be treated as lower case. 


When you have logged in successfully, the shell will type a $ to 
you. (The shell is described below under How to run a program. ) 


For more information, consult login(1), which discusses the login 
sequence in more detail, and stty(1), which tells you how to 
describe the characteristics of your terminal to the system. 
Profile(4) tells how to have the shell automatically perform 
startup tasks when you log in. To log out, type an end-of-file 
indication to the shell (ASCII EOT character; the FINISH key on 
a Convergent Programmable Terminal, control-d on most 
others). The shell terminates and the login: message appears 
again. 


How to communicate through your terminal. When you 
type, the system is gathering your characters and saving them. 
These characters will not be given to a program until you type a 
“return” (or “new-line”), as described above in Logging in. 


Terminal input/output is full-duplex. It has full read-ahead, 
which means that you can type at any time, even while a 
program is typing at you. Of course, if you type during output, 
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the output will have interspersed in it the input characters. 
However, whatever you type will be saved and interpreted in the 
correct sequence. There is a limit to the amount of read-ahead, 
but it is generous and not likely to be exceeded unless the system 
is in trouble. When the read-ahead limit is exceeded, the system 
throws away all the saved characters. 


On an input line from a terminal, the character @ “kills” all the 
characters typed before it. The BACKSPACE character (control-h 
if your terminal lacks a backspace key) erases the last character 
typed. Successive uses of BACKSPACE will erase characters back 
to, but not beyond, the beginning of the line; @ and 
BACKSPACE can be typed as themselves by preceding them with 
\ (thus, to erase a \, you need two BACKSPACEs). These default 
erase and kill characters can be changed; see stty(1). 


The ASCII DC3 (control-s) character can be used to temporarily 
stop output. It is useful with CRT terminals to prevent output 
from disappearing before it can be read. Output is resumed 
when a DC1 (control-q) or a second DC3 (or any other character, 
for that matter) is typed. The DC1 and DC3 characters are not 
passed to any other program when used in this manner. 


The ASCII] DEL (a.k.a. “rubout”, Programmable Terminal 
DELETE key) character is not passed to programs, but instead 
generates an interrupt signal, just like the ‘“break’’, “‘interrupt”’, 
or “attention” signal. This signal generally causes whatever 
program you are running to terminate. It is typically used to 
stop a long printout that you don’t want. However, programs 
can arrange either to ignore this signal altogether, or to be 
notified when it happens (instead of being terminated). The 
editor ed(1), for example, catches interrupts and stops what it is 
doing, instead of terminating, so that an interrupt can be used to 
halt an editor printout without losing the file being edited. 


The quit signal is generated by typing the ASCII FS character 
(Programmable Terminal CODE-CANCEL, Control-\ on other 
terminals). It not only causes a running program to terminate, 
but also generates a file with the “core image’’ of the terminated 
process. Quit is useful for debugging. 


The system tries to be intelligent as to whether you have a 
terminal with the ‘‘new-line’’ function, or whether it must be 
simulated with a “‘carriage-return”’ and “‘line-feed”’ pair. In the 
latter case, all input ‘‘carriage-return” characters are changed to 
‘“‘line-feed” characters (the standard line delimiter), and a 
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“carriage-return”’ and ‘“‘line-feed” pair is echoed to the terminal. 
If you get into the wrong mode, the stty(1) command will rescue 
you. 


Tab characters are used freely in programs. If your terminal 
does not have the tab function, you can arrange to have tab 
characters changed into spaces during output, and echoed as 
spaces during input. Again, the stty(1) command will set or reset 
this mode. The system assumes that tabs are set every eight 
character positions. The tabs(1) command will set tab stops on 
your terminal, if that is possible. 


How to run a program. When you have successfully logged 
on, a program called the shell is listening to your terminal. The 
shell reads the lines you type, splits them into a command name 
and its arguments, and executes the command. A command is 
simply an executable program. Normally, the shell looks first in 
your current directory (see The current directory below) for a 
program with the given name, and if none is there, then in 
system directories. There is nothing special about system- 
provided commands except that they are kept in directories 
where the shell can find them. You can also keep commands in 
your own directories and arrange for the shell to find them there. 


The command name is the first word on an input line to the 
shell; the command and its arguments are separated from one 
another by space and/or tab characters. 


When a program terminates, the shell will ordinarily regain 
control and type a $ at you to indicate that it is ready for 
another command. The shell has many other capabilities, which 
are described in detail in sh(1). 


The current directory. The CTIX file system is arranged in a 
hierarchy of directories. When the system administrator gave 
you a user name, he or she also created a directory for you 
(ordinarily with the same name as your user name, and known as 
your login or home directory). When you log in, that directory 
becomes your current or working directory, and any file name 
you type is by default assumed to be in that directory. Because 
you are the owner of this directory, you have full permissions to 
read, write, alter, or destroy its contents. Permissions to have 
your will with other directories and files will have been granted 
or denied to you by their respective owners, or by the system 
administrator. To change the current directory use cd(1). 


Path names. To refer to files not in the current directory, you 
must use a path name. Full path names begin with /, which is 
the name of the root directory of the whole file system. After 
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the slash comes the name of each directory containing the next 
sub-directory (followed by a /), until finally the file name is 
reached (e.g., /usr/ae/filex refers to file filex in directory ae, 
while ae is itself a subdirectory of usr; usr springs directly from 
the root directory). See tntro(2) for a formal definition of path 
name. 


If your current directory contains subdirectories, the path names 
of files therein begin with the name of the corresponding 
subdirectory (without a prefixed /). Without important 
exception, a path name may be used anywhere a file name is 
required. 


Important commands that modify the contents of files are cp(1), 
mv, and rm(1), which respectively copy, move (i.e., rename), and 
remove files. To find out the status of files or directories, use 
Is(1). Use mkdir(1) for making directories and rmdir(1) for 
destroying them. 


For a fuller discussion of the file system, see the references cited 
at the beginning of the INTRODUCTION above. It may also be 
useful to glance through Section 2 of this manual, which 
discusses system calls, even if you don’t intend to deal with the 
system at that level. 


Writing a program. To enter the text of a source program 
into a file, use ed(1), ex(1), or vi(1). After the program text has 
been entered with the editor and written into a file (whose name 
has the appropriate suffix), you can give the name of that file to 
the appropriate language processor as an argument. Normally, 
the output of the language processor will be left in a file in the 
current directory named a.out (if that output is precious, use 
mv(1) to give it a less vulnerable name). 


When you have finally gone through this entire process without 
provoking any diagnostics, the resulting program can be run by 
giving its name to the shell in response to the $ prompt. 


If any execution (run-time) errors occur, you will need adb(1) to 
examine the remains of your program. 


Your programs can receive arguments from the command line 
just as system programs do; see ezec(2). 


Surprises. Certain commands provide inter-user 
communication. Even if you do not plan to use them, it would 
be well to learn something about them, because someone else 
may aim them at you. To communicate with another user 
currently logged in, write(1) is used; matl(1) will leave a message 
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whose presence will be announced to another user when he or she 
next logs in. The corresponding entries in this manual also 
suggest how to respond to these two commands if you are their 
target. 


When you log in, a message-of-the-day may greet you before the 
first $. 


Changes from UNIX System V. The CTIX Operating System 
Manual, Verston B, documents CTIX for MightyFrame and 
MiniFrame systems, which is derived from UNIX System V, 
Release 2.2. 


The CTIX Operating System Manual, Verston B, also includes 
descriptions of the CTIX Internetworking programs and tools. 


These are the important changes in UNIX software in CTIX: 


The language support provided by the bs, efl, ratfor, sno, 
and {77 programs. In their place, Convergent Technologies 
can provide the following CTIX languages: GSA high level 
COBOL; GSA-certified FORTRAN 77; Pascal; BASIC. 


A terminal name is of the form ttyzzz instead of ttyzz. 
RS-232 terminal numbers range from tty000 to tty255; RS- 
422 terminal numbers range from tty256 to tty511. 


There are two changes in terminal defaults. The default 
speed for RS-232 terminals is 9600 baud instead of 300 baud. 
The default erase character for all terminals is BACKSPACE 
(control-h if your terminal lacks a BACKSPACE key) instead 
of #. 


Ls columnizes its output by default if the standard output is 
a terminal, making /s easier to use on video terminals. This 
convention and the associated —C option are borrowed from 
the Berkeley Software Distribution. 


Many Berkeley Software Distribution programs, libraries, 
and networking programs are included. See especially the 
indispensible head(1), mklost+found(1), more(1), renice(1), 
and ul(1). In addition to the AT&T curses (based on 
terminfo(4)), the Berkeley ocurse library (based on 
termcap(4)) is supported. 


Compatibility of CTIX features. The following lists are 
provided for cross-machine comparisons of commands and files 
on Convergent systems. The programs listed in the categories 
below are not provided with the standard UNIX System V 
operating system. 


5/86 -5- 


Note: Most CTIX commands for MightyFrame and MiniFrame 
systems are compatible with CTIX operating systems on other 
Convergent systems (e.g., MegaFrame), as well as with other 
operating systems based on the UNIX System V operating 
system. In this manual commands or certain features that apply 
only to one system are clearly announced in the text. Note that 
although most CTIX commands on MightyFrame and MiniFrame 
systems are CTIX- and UNIX-compatible, they may not be 
identical on other computer systems (including Convergent 
systems); to ensure portability, compare the documentation for 
each system to be used. 


MintFrame Only: 


See the following pages for CTIX features that are provided by 
Convergent exclusively for MiniFrame systems; they are not 
available on other CTIX or UNIX systems: 


Section 1: dismount(1), setadr(1NM), setenet(1NM). 


MightyFrame and MintFrame Only: 


See the following pages for CTIX features that are provided by 
Convergent exclusively for MightyFrame and MiniFrame 
systems; they are not available on other CTIX or UNIX systems: 


Section 1: zmset(1M). 


Berkeley Software Distribution (BSD): 


These programs are based on the Berkeley Software Distribution 
and are not provided with standard UNIX System V. They 
include many of the programs that make up the OTIX 
internetworking package. 


Section 1: catman(1), clear(1), csh(1), ctags(1), expand(1), 
fold(1), head(1), tfconfig(1NM), more(1), rep(1N), 
rerecd(1NM), rwho(1N), rwhod(1NM), sertpt(1NM), 
strings(1NM), telnet(1N), telnetd(1NM), tftpd(1NM), 
trpt(1NM), tset(1NM), ul(1), wall(1), xstr(1). 

Section 2: accept(2N), bind(2N), getpeername(2N), 


getsockname(2N), getsockopt(2N), listen(2N), recv(2N), 
send(2N), shutdown(2N), socket(2N). 


Section 3: byteorder(3N), gethostent(3N), gethostname(3N), 
getnetent(3N), getprotoent(3N), inet(3N), ocurse(3X), 
remd(3N), rexec(3N), termcap(3X). 
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Section 4: hosts(4N), networks(4N), protocols(4N), 
services(4N). 


Section 6: advent(6). 
Convergent Systems Only: 


The following pages apply only to Convergent systems. 
(See also ‘‘MegaFrame Only” above.) 


Section 1: beopy(1M), ctinstall(1), lpset(1M), qinstall(1), 
qiltst(1), update(1M). 

Section 2: locking(2). 

(Note: This is not an exhaustive list of all CTIX features. 
For further information about the special features of CTIX 
on other Convergent systems (such as MegaFrame), see the 


appropriate operating system manuals and_ Release 
Notices.) 
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PERMUTED INDEX 





This index includes entries for all pages of both Volumes 1 and 2. 
The entries themselves are based on the one-line descriptions or 
titles found in the NAME portion of each manual page; the 
significant words (keywords) of these descriptions are listed 
alphabetically down the center of the index. 


The index is actually a keyword-in-context (KWIC) index that 
has three columns. To use the index, read the center column to 
look up specific commands by name or by subject topics. Note 
that the entry may begin in the left column or wrap around and 
continue into the left column. A period (.) marks the end of the 
entry, and a slash (/) indicates where the entry has been 
continued or truncated. The right column gives the manual page 


where the command or subject is described. 


/functions of HP 2640 and 2621-series terminals. .. . hp(1) 
/special functions of HP 2640 and 2621-series/ .. . hp(1) 
special functions of/ 300, 300s: handle ..... ai 
/functions of DASI 300 and 300s terminals. . . 300(1) 
functions of DASI/ 300, 300s: handle special .. . . 300(1) 
/of DASI 300 and 300s terminals. ... ..» « 300(1) 
/ltol3: convert between 3-byte integers and long/ . . 13tol(3C) 
comparison. diff8: 3-way differential file . . . diff3(1) 
TEKTRONIX 4014/ 4014: paginator forthe . . . 4014(1) 
/for the TEKTRONIX 4014 terminal ..... . 4014(1) 
functions of the DASI/ 450: handle special . .. . 450(1) 
functions of the DASI 450 terminal. /special . . . 450(1) 
/parameters for Xylogics 772 half-inch tape/ ~~. - xmset(1M) 
between long integer/ a64l, 64a: convert . . . . . a641(3C) 
fault. abort: generatean IOT . . abort(3C) 
absolute value. abs: return integer . . . . . abs(3C) 
adb: absolute debugger. ... . adb(1) 
abs; return integer absolute value. ..... - abs(3C) 
ceiling, remainder, absolute value/ /floor, . . . floor(3M) 
tiop: terminal accelerator interface. . . . - tiop(7) 
socket. accept: accept a connection on a . accept(2N) 
connection on a socket. accept: accepta ..- .. - accept(2N) 
allow/prevent LP/ accept, reject: . . - - . . . accept(1M) 
times of/ touch: update access and modification - touch(1) 
times. utime: set file access and modification - utime(2) 
accessibility of a/ access: determine .. .. ~ access(2} 
numerical/ graphics: access graphicaland ... . graphics(1G) 
drvalloc, drvbind: access loadable drivers. . . . Iddrv(2) 
in a/ sputl, sgetl: access long integer data - sputl(3X) 
sadp: disk access profiler. ... .. . sadp(1M) 
common object file access routines. Idfen: . . . Idfen(4) 
file systems for optimal access time. /eopy .. . . dcopy({1M) 
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locking: exclusive 
/endutent, utmpname: 
access: determine 

or disable process 
acctcon2: connect-time 
acctpre2: process 

shell procedures for 
acctwtmp: overview of 
/and miscellaneous 
diskusg: generate disk 
acct: per-process 
/search and print process 
/merge or add total 
/summary from per-process 
/manipulate connect 
runacct: run daily 
process accounting. 
accounting file format. 
from per-process/ 
print process/ 
connect-time/ 
accounting. acctconl, 
accton, acctwtmp:/ 
acctwtmp:/ acctdisk, 
total accounting files. 
acctdisk, acctdusg, 
process accounting. 
accounting. acctprcel, 
/acctdusg, accton, 

sin, cos, tan, asin, 
killall: kill all 

sag: system 

sal, sa2, sadc: system 
sar: system 

SCCS file editing 
process data and system 
protocols. Dialers: 
hopefully interesting, 


acctmerg: merge or 
putenv: change or 

/set DARPA Internet 
/inet_netof: Internet 
setenet: write Ethernet 
administer SCCS files. 
admin: create and 
interface. swap: swap 
Cave. 

alarm: set a process 
alarm clock. 

data segment space 
calloc: main memory 
fast main memory 
accept, reject: 

running process/ renice: 
sort: sort 

and link editor output. 
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access to regions ofa/ .. . 
access utmp file entry. .. . 
accessibility of afile. . ... 
accounting. /fenable .... 
accounting. acctconl, ... 
accounting. acctprel, ... 
accounting. /turnacct: .. . 
accounting and/ /accton, . 
accounting commands. .. . 
accounting data by user/ . . 
accounting file format. ... 
accounting file(s). ..... 
accounting files. ...... 
accounting records. .... 
accounting records. .... 
accounting. 
acct: enable or disable ... 
acct: per-process ee eee 
acctems: command summary 
acctcom: search and 
acctconl, acctcon2: .... 
acctcon2: connect-time ... 
acetdisk, acctdusg, .... 
acctdusg, accton, 
acctmerg: merge or add. . 
accton, acctwtmp:/  . « + 
acctprel, acctprc2: ... 
acctpre2: process 
acctwtmp: overview of/ 
acos, atan, atan2:/ 
active processes. 
activity graph. ...- 
activity report package. 
activity reporter. 
activity. /print current .. 
activity. /report . 2. + +. 
ACU/modem calling . ... 
adage. /printarandom, . . 
adb: absolute debugger. .. 
add total accounting/ ... 
add valueto/ ....... 
address from node name. . . 
address manipulation/ ... 
address on disk. . . 2» « « 
admin: create and 
administer SCCS files. . . . 
administrative ... s+ 
advent: explore Colossal . . 
alarm clock. 
alarm: set a process .... 
allocation. /change ... . 
allocator. /realloc, .... 
allocator. /mallinfo: .... 
allow/preventLP/ .... 
alter priority of 
and/or merge files. ....- 
a.out: common assembler oe 


oe we we ee ee 


oe ee © 


locking(2) 
getut(3C) 
access(2) 
acct(2) 
acetcon(1M) 
acetpre(1M)} 
acctsh(1M) 
acct(1M 
acct(iM 
diskusg(1M) 
acct(4) 
acctcom(1) 
acctmerg(1M) 
acetems(iM) 
fwtmp(1M) 
runacct(1M) 
acct(2) 

acct (4) 
acctems(1M) 
acctcom(1) 
acctcon(1M) 
acctcon(1M) 
acct(1M) 
acct(1M) 
acctmerg(1M) 
acct(1M) 
acctpre(1M) 
acct pre(1M) 
acct(1M) 
trig(3M) 
killall(1M) 
sag(1G) 
sar(1M) 
sar(1) 
sact(1) 
timex(1) 
Dialers(5) 
fortune(6) 
adb(1) 
acctmerg(1M) 
putenv(3C) 
setaddr(1NM) 
inet(3N) 
setenet(INM) 
admin(1) 
admin(1) 
swap(1M) 
advent(6) 
alarm(2) 
alarm(2) 
brk(2) 
malloe(3C) 
malloc(3X) 
accept(1M) 
renice(1) 
sort(1) 
a.out(4) 


/to commands and 
maintainer for portable/ 
format. 

number: convert 
arithmetic/ be: 
maintainer for/ ar: 
cpio: format of cpio 

ar: common 

header of a member of an 
/convert object and 
Idahread: read the 

tar: tape file 

maintainer for portable 
cpio: copy file 

varargs: handle variable 
/output of a varargs 
xargs: construct 

/get option letter from 
expr: evaluate 

echo: echo 

be: arbitrary-precision 
drill in number facts. 
expr: evaluate arguments 


/and detach serial lines 
/locate a terminal to use 
asa: interpret 

carriage control/ 

ascii: map of 

hd: hexadecimal and 
character set. 

long integer and base-64 
atof: convert 

strings: extract the 
date/ /localtime, gmtime, 
sin, cos, tan, 

help: 

editor/ a.out: common 
as: 

assertion. 

assert: verify program 
setbuf, setvbuf: 

out the list of blocks 
commands at a later/ 
cos, tan, asin, acos, 
/tan, asin, acoe, atan, 
string to/ 

strtod, 

integer. strtol, atol, 
string to/ strtol, 
slattach, sldetach: 
process. wait: 

and processing/ 
ungetc: push character 
backgammon. 

back: the game of 

fine: fast incremental 
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application programs. 
ar: archive and library 
ar: common archive file 
Arabic numerals to/ . 
arbitrary-precision . . 
archive and library . 
archive. ‘ 
archive file format. . 
archive file. /archive 
archive files to common/ 
archive header of a/ 
archiver. 


ee 2 ew we we 


archives. /and library . . 


archives in and out. .. 
argument list. . . 2... 
argument list. . . . .. 


argument list(s) and/ .. 


argument vector. . . 
arguments asan/ . . 
arguments. . . « « « 
arithmetic language. . 
arithmetic: provide . 
as an expression. . . 
as: assembler. 
as network interfaces. 

as the virtual system/ 

ASA carriage control/ . 
asa: interpret ASA. . 
ASCII character set. . . 


ascii file dump. 
ascii: map of ASCII . 
ASCII string. /between 
ASCll string tof ... 
ASCII text strings in a/ 
asctime, tzset: convert . 
asin, acos, atan, atan2:/ 
ask for help. 
assembler and link .. 
assembler. 
assert: verify program 
assertion. 
assign buffering toa/ . 
associated with/ /print 
at, batch: execute ... 
atan, atan2:/ sin, . . . 
atan2: trigonometric/ . 
atof: convert ASCII .. 
atof: convert string to/ . 
atoi: convert string to 
atol, atoi: convert ... 
attach and detach serial/ 


await completion of ... 


awk: pattern scanning . 
back into input stream. 

back: the game of ... 
backgammon. ..-... 
backup. 


- intro(1) 
- ar(1) 


ar(4) 
number(6) 
be(1) 

ar(1) 

epio(4) 

ar(4) 
Idahread(3X) 


- convert(1) 
- Idahread(3X) 
- tar(1} 


ar(1) 
epio(1) 


- varargs(5) 


vprintf(3S) 
xargs(1) 
getopt(3C) 
expr(1) 
echo(1) 

be(1) 
arithmetic(6) 


- expr(l) 


as(1) 
slattach(1NM) 
conlocate(1M) 
asa(1) 

asa(1) 

ascii(5) 

hd(1) 

ascii(5) 
a641(3C) 
atof(3C) 
strings(1) 
ctime(3C) 
trig(3M) 
help(1) 
a.out(4) 

as(1) 
assert(3X) 
assert(3X) 
setbuf(3S) 
bcheck(1M) 


- at(1) 


trig(3M) 


. trig(3M) 
- atof(3C) 


strtod(3C) 


- strtol(3C) 
- » strtol(3C) 


slattach(1NM) 
wait(1) 

awk(1) 
ungetc(3S) 


- back(6} 
- back(6) 
- finc(1M) 


recover files from a 


terminal capability data 
terminal capability data 
/between long integer and 
/(visual) display editor 
proto file; set links 
deliver portions of / 

at a later time. at, 
arithmetic language. 
list of blocks/ 

drvload: system/ bre, 
copy. 


cb: C program 
10, jl, jn, yO, yl, yn: 


/install object files in 
fread, fwrite: 

table. bsearch: 
/tdelete, twalk: manage 
bind: 

socket. 

jack. 

bj: the game of 

beopy: interactive 

sum: print checksum and 
syne: update the super 
/print out the list of 
number of free disk 
manipulate Volume Home 
powerfail, drvload:/ 
segment space/ 

sorted table. 

stdio: standard 

setbuf, setvbuf: assign 
mknod: 

vme: VME 

between host and network 
swab: swap 

ce: 

cflow: generate 

cpp: the 

includes: determine 

cb: 

lint: a 

exref: generate 

ctrace: 

and share strings in 
cprofile: setting up a 


de: desk 

eal: print 

service. 

system. cu: 

returned by stat system 
Dialers: ACU/modem 
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banner: make posters. .. 


base. termcap: 
base. terminfo: . 


frec(1M) 


- banner(1) 


base-64 ASCH string. ... 


based on ex. «2 ees 
based on. /lists from . 
basename, dirname: . . 
batch: execute commands 


be: arbitrary-precision ... 
beheck: print out the .. 
beheckre, rc, powerfail, . . . 
» beopy(1M) 


bcopy: interactive block 
bdiff: big diff... ... 
beautifier. 
Bessel functions. . 


bfs: big filescanner. .... 


binary directories. . 
binary input/output. . 
binary search a sorted 


binary search trees. .. « 


bind a name to a socket. 
bind: bind a name toa . 
bj: the game of black 
black jack. 
block copy. 
block count of a file. . . 
block. «2 oe eee e 
blocks associated with/ 
blocks. df: report .. 
Blocks (VHB). libdev: 
bre, beheckre, rc, 
brk, sbrk: change data 
bsearch: binary search a 
buffered input/output/ 


ee 


buffering toastream. .. 


build special file. 
bus interface. 
byte order. /values .. 
bytes. 


eee ew eo we we 


C compiler. ... 2.2. 


C flowgraph. 
C language preprocessor. 


ee © © we 


C language preprocessor/ . 


C program beautifier. . 
C program checker. 
C program/ 
C program debugger. 

C programs. /extract . 
C shell environment at/ 
cal: print calendar. .. 
calculator. 
calendar. 


oe ew 


calendar: reminder .... 


call another computer . 
call. stat: data 
calling protocols. 


termcap(4) 
terminfo(4) 
a641(3C) 
vi(1) 

qlist(1) 
basename(1) 
at(1) 

be(1) 


- beheck(1M) 


bre(1M) 


bdiff(1) 
cb(1) 
bessel(3M) 
bfs(1) 
cpset(1M) 
fread(3S) 


- bsearch(3C) 


tsearch(3C) 


. bind(2N) 


bind(2N) 


. bj(6) 


bi(6) 
beopy(1M) 
sum(1) 
syne(1) 
beheck(1M) 
df(1M) 
libdev(3X) 
bre(1M) 
brk(2) 
bsearch(3C) 
stdio(3S) 
setbuf(3S) 
mknod(1M) 
vme(7) 
byteorder(3N) 
swab(3C) 
ec(1) 
eflow(1) 
cpp(1) 
includes(1) 


- cb(1) 


lint(1) 
exref(1) 
ctrace(1) 
xstr(1) 
cprofile(4) 
cal(1) 
de(1) 
cal(1) 
calendar(1) 
cu(1C) 


- stat(5) 


Dialers(5) 


malloc, free, realloc, 
malloc, free, realloc, 
/introduction to system 
link and unlink system 
requests to an LP/ Ip, 
termcap: terminal 
terminfo: terminal 

asa: interpret ASA 
(variant of ex for 

print files. 

catman: create the 

files for the manual. 
advent: explore Colossal 
beautifier. 


directory. 

commentary of an SCCS/ 
ceiling,/ floor, 

/ceil, fmod, fabs: floor, 
flowgraph. 

delta: make a delta 

of running process by 
create an interprocess 
terminal’s local RS-232 
input/ ungetc: push 
for/ eqnchar: special 
the user. cuserid: get 
/fgetc, getw: get 
/fpute, putw: put 

ascii: map of ASCII 
ASA carriage control 
toascii: translate 
isascii: classify 

tr: translate 

dodisk, lastlogin,/ 
directory. 

/file system consistency 
directories/ uucheck: 
constant-width text/ cw, 
mathematical/ eqn, neqn, 
lint: a C program 
password /group file 

file systems with label 
systems processed by/ 
documents/ mm, osdd, 
of a file. sum: print 
group. chown, 

times: get process and 
wait: wait for 


file. 

group of a file. 
owner or group. 
directory. 

directory for a/ 
lastlogin,/ chargefee, 
/iscntrl, isascii: 
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calloc: main memory / 
calloc, mallopt,/ ...... 
calls and error numbers. 
calls. /unlink: exercise . . 
cancel: send/cancel .... 
capability data base. . ... 
capability data base. . .. . 
carriage control/ ..... 
casual users). /editor 
cat: concatenate and .... 
cat files forthe/ ...... 
catman: create the cat ... 
Caves. We elie cab Ssease! 0 98 
cb: C program ...... 
ce: C compiler. .. 2... 
ed: change working .... 
ede: change the delta ... 
ceil, fmod, fabs: floor, ... 
ceiling, remainder,/ ... . 
cflow: generateC ..... 
(change) to an SCCS/ ... 
changing nice. /priority .. 
channel. pipe: .. 2... 
channels. /controlling . . 
character back into ... 
character definitions ... 
character login name of . 
character or word from a/ 
character or word on a/ 

character set. . 2. 2. 
characters. /interpret . 
characters. /_tolower, . 
characters. /iscntrl, . . 
characters. «2.2 ee 
chargefee, ckpacct, . . 
chdir: change working . 
check and interactive/ . 
check the UUCP ... 
checkew: prepare ....e. 
checkeq: format ...... 
checker. 2» 2 se ee wee ee 
checkers. pwek, grpck: ... 
checking. /labelit: copy 

checklist: list of file ... 
checkmm: print/check .. . 
checksum and block count 
chgrp: change owner or 

child process times. .... 
child process to stop or/ 
chmod: change mode. ... 
chmod: change mode of 
chown: change owner and . 
chown, chgrp: change .. 
chroot: change root .... 
chroot: change root ... 
ckpacct, dodisk, ...... 
classify characters. .... 


- chown( 


- malloe(3C) 


malloc(3X) 


+ « intro(2) 
. link(1M) 


Ip(1) 
termcap(4) 
terminfo(4) 
asa(1) 


- edit(1) 


cat(1) 
catman(1) 
catman(1) 
advent(6) 
eb(1) 

ec(1) 

ed(1) 
ede(1) 
floor(3M) 
floor(3M) 
cflow(1) 
delta(1) 
renice(1) 
pipe(2) 
tp(7) 
ungetc(3S) 
eqnchar(5) 
cuserid(3S) 
getc(3S) 
pute(3S) 
ascii(5) 
asa(1) 
conv(3C) 
etype(3C) 
tr(1) 
acctsh(1M) 
chdir(2) 
fsck(1M) 
uucheck(1M) 
ew(1) 
eqn(1) 
lint(1) 
pwck(1M) 
volcopy(1M) 


- checklist(4) 


mm(1) 


» sum(1) 
+ chown(1) 


times(2} 


- wait(2) 


chmod(1) 


- chmod(2) 


chown(2) 
1) 
) 


chroot(2 


- chroot(1M) 


acctsh(1M) 
etype(3C) 


uuep spool directory 
screen. 

elri: 

clear: 

status/ ferror, feof, 
interpreter) with 
set a process alarm 
cron: 

used. 

Idclose, Idaclose: 
close: 

descriptor. 

fclose, fflush: 


line-feeds. 

advent: explore 

deltas. 

comb: 

lines common to two/ 
nice: run a 

root directory for a 

env: set environment for 
remd: remote shell 

uux: CTIX to CTIX remote 
hangups/ nohup: run a 
with/ csh: a shell 
getopt: parse 

executable file for 

/the standard /restricted 
a stream to a remote 
data and/ timex: time a 
uuxqt: execute remote 
stream to a remote 
per-process/ acctcms: 
system: issue a shell 
condition evaluation 
time: time a 

list(s) and execute 
miscellaneous accounting 
intro: introduction to 
at, batch: execute 
graphical and numerical 
install: install 

mkhosts: make node name 
useful with graphical 
ede: change the delta 
format. ar: 

link editor/ a.out: 

and archive files to 
access routines. Idfen: 
Idopen, Idaopen: open a 
/line number entries of a 
/\daclose: close a 

/the file header of a 

/of a section of a 

/file header of a 
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clean-up. uucleanup: .. 
clear: clear terminal . .. 
clear i-node. 
clear terminal screen. .. 
clearerr, fileno: stream 
C-like syntax. /(command 
clock. alarm: 
clock demon. 
clock: report CPU time 

close a common object / 

close a file descriptor. . 
close: close a file . ... 
close or flush a stream. . 
clri: clear i-node. 
cmp: compare two files. 
col: filter reverse 
Colossal Cave. 


ee 


comb: combine SCCS ... 


combine SCCS deltas. 
comm: select or reject . . 
command at low priority. 
command. chroot: change 


command execution. . . 
command execution. .. 
command immune to 
(command interpreter) . 
command options. .. 
command. path: locate 
command programming/ 
command. /for returning 
command; report process 
command requests. 
command. rexec: return 
command summary from 
command. ..+.-s-» 
command. test: 
command. . ++... 
command. /argument . 
commands. /and 
commands and application 
commands at alater/ . 
commands. /access .. . 
commands. 
commands. 
commands. /network . . 
commentary of an SCCS/ 
common archive file 
common assembler and. 
common formats. /object 
common object file ... 
common object file for/ 


ee 


ome 2 © ee 


+ uucleanup(1M) 


clear(1) 


» » clri(1M) 


clear(1) 
ferror(3S) 


- esh(1) 


alarm(2) 


- cron(1M) 


clock(3C) 
Idclose(3X) 


- close(2) 


close(2) 


. fclose(3S) 


elri(1M) 
emp(1) 


- col(1) 


advent(6) 
comb(1) 


- comb(1) 


comm(1) 


» nice(1) 
. chroot(1M) 
command execution. .... 


env(1)} 
remd(1N) 


» uux(1C) 
- nohup(1) 


esh(1) 
getopt(1) 
path(1) 


timex(1) 
uuxqt(1M) 
rexec(3N) 
acctcms(1M) 
system(3S) 
test(1) 
time(1) 


- xargs(1) 


acct(1M) 
intro(1) 

at(1) 
graphics(1G) 
install(1M) 
mkhosts(1NM) 
stat(1G) 

ede(1)} 


convert(1) 


- Idfen(4) 


common object file/ .... 


common object file. 
common object file. 
common object file. 
common object file. 


Idopen(3X) 
idlread(3X) 
ldclose(3X) 
Idfhread(3X) 
Idlseek(3X) 
Idohseek(3X) 


/of a section of a 
/section header of a 
/section of a 

symbol table entry of a 
/symbol table entry of a 
/to the symbol table of a 
/\ine number entries in a 
nm: print name list of 
/information for a 
/section header for a 
/information from a 
/retrieve symbol name for 
symbol table/ syms: 
filehdr: file header for 
Id: link editor for 

/print section sizes of 
/select or reject lines 
/report inter-process 
/standard interprocess 
create an endpoint for 
/file for uucp 

diff: differential file 
emp: 

an SCCS file. scesdiff: 
3-way differential file 
diremp: directory 
regular/ regemp, regex: 
/regular expression 
regular expression 

term: format of 

ce: C 

tic: terminfo 

yace: yet another 

/erfc: error function and 
wait: await 

pack, pcat, unpack: 
symbol table/ Idtbindex: 
cu: call another 

files. cat: 

command. test: 

system. 

uucp/ Devices: 

config: 

interface/ ifconfig: 
spooling/ lpadmin: 
terminal to use as the/ 
/wtmpfix: manipulate 
connection on a socket. 
getpeername: get name of 
out-going terminal fine 
accept: accept a 
connect: initiate a 

part of a full-duplex 
listen: listen for 
acctconl, acctcon2: 
fsck, dfsck: file system 
as the virtual system 
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common object file. . . 
common object file .. 
common object file. . . 
common object file. 
common object file. .. 
common object file. .. 
common object file. .. 
common object file. .. 
common object file. .. 
common object file. . . 
common object file. .. 
common object file/ . . 
common object file .. 
common object files. . . 
common object files. . . 
common object files. . . 
common to two sorted / 

communication facilities / 
communication package. 
communication. socket: 

communications lines. . 
comparator. 
compare two files. 
compare two versions of 

comparison. diff8: . .. 
comparison. 
compile and execute . 
compile and match/ . 
compile. regemp: . . 
compiled term file... 
compiler. 
compiler. 
compiler-compiler. . . . 
complementary error/ . 
completion of process. . 
compress and expand/ . 
compute the index of a . 
computer system. 
concatenate and print . 
condition evaluation . . 
config: configure a CTIX 
configuration file for 


eee ee 


oe 8 @ 


oe ee we ee 


configure a CTIX system. 


configure network .. . 
configure the LP ... 
conlocate: locatea .. . 
connect accounting/ . . 
connect: initiatea .. . 
connected peer. ... . 
connection. /an.... 
connection on a socket. 

connection on a socket. 

connection. /shut down 
connections on a socket. 
connect-time accounting. 
consistency check and/ . 
console. /touse ... . 


ee ee 
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ldrseek(3X) 
ldshread(3X) 
Idsseek(3X) 
Idtbindex(3X) 
ldtbread(3X) 
Idtbseek(3X) 
linenum(4) 
nm(1) 

reloc(4) 
senhdr(4) 
strip(1) 
Idgetname(3X) 
syms(4) 
filehdr(4) 
1d(1) 

size(1) 
comm(1) 
ipes(1) 
stdipe(3C) 
socket(2N) 
Devices(5) 
diff(1) 

emp(1) 
sccsdiff(1) 
diff'3(1) 
diremp(3) 
regemp(3X) 
regexp(5) 
regemp(1) 
term(4) 

ee(1) 

tic(1M) 
yace(1) 
erf(3M) 
wait(1) 
pack(1) 
Idtbindex(3X) 
cu{1C) 

cat(1) 

test(1) 
config(1M) 
Devices(5) 
config(1M) 
ifconfig(INM) 
{padmin(1M) 
conlocate(1M) 
fwtmp(1M) 
connect(2N) 
getpeername(2N) 
dial(3C) 
accept(2N) 
connect(2N) 
shutdown(2N) 
listen(2N) 
acctcon(1M) 
fsck(1M) 
conlocate(iM) 


terminal. 

console: 

math: math functions and 
cw, checkew: prepare 
mkfs: 

list(s) and/ xargs: 

/tbl, and eqn 

with/ Uutry: try to 

Is: list 

toc: graphical table of 
esplit: 

/interpret ASA carriage 
ioctl: 

fentl: file 

init, telinit: process 
msgctl: message 

semctl: semaphore 
shmcetl: shared memory 
fentl: file 

status inquiry and job 
ve: version 

772 half-inch tape 
interface. tty: 

local RS-232/ tp: 
terminals. term: 

units: 

dd: 

to English. number: 
floating-point / atof: 
integers/ 13tol, ltol3: 
integer and/ a64l, 164a: 
and archive files to/ 
/gmtime, asctime, tzset: 
ecvt, fevt, gevt: 

scanf, fscanf, sscanf: 
archive files/ convert: 
strtod, atof: 

strtol, atol, atoi: 
/htons, ntohl, ntohs: 
dd: convert and 

bcopy: interactive block 
and out. cpio: 

optimal access/ dcopy: 
label/ volcopy, labelit: 
files. cp, In, my: 

rep: remote file 

system to CTIX system 
CTIX-to-CTIX system file 
for the UUCP/ uucico: 
image file. 

core: format of 

atan, atan2:/ sin, 
functions. sinh, 

print checksum and block 
we: word 

or move files. 

cpio: format of 
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console: console ..... « 
console terminal. ..... 
constants. . « « « « « « « 
constant-width text for/ 
construct a file system. . 
construct argument 
constructs. 
contact a remote system 
contents of directory. 
contents routines. 
context split. 
control characters. . 
control device. 
control. 
control initialization. 
control operations. 
control operations. 
control operations. 
control options. . 
control. uustat: uucp. 
control. : 
controller. /Xylogics . . 
controlling terminal .. 


ese es 


controlling terminal’s 
conventional names for 
conversion program. . 
convert and copy a file. 
convert Arabic numerals 
convert ASCH string to 
convert between 3-byte 
convert between long. 
convert: convert object . 
convert date and time to/ 
convert floating-point/ . 
convert formatted input. 
convert object and 
convert string to/ .. - 
convert string to/ .. . 
convert values between/ 
copy a file. 
copy. 
copy file archivesin . . 
copy file systems for . . 
copy file systems with . 
copy, link or move . . . 


oce ses ee we 


copy. 
copy. uucp: CTIX .. 
copy. /uupick: public 
copy-in/copy-out program 
core: format of core 
core image file. . 
cos, tan, asin, acos, . . 
cosh, tanh: hyperbolic . 
count of a file. sum: . . 


ee ees eee 


count. 
cp, In, mv: copy, link 
cpio archive. 


console(7) 
console(7) 
math(5) 
ew(1) 
mkfs(1M) 
xargs(1) 
deroff(1) 
Uutry(1M) 
1s(1) 
toc(1G) 
esplit(1) 
asa(1) 
ioct!(2) 
fentl(2) 
init(1M) 
msgctl(2) 
semctl(2) 
shmetl(2) 
fentl(5) 
uustat(1C) 
ve(1) 
xmset(1M) 
tty(7) 
tp(7) 
term(5) 
units(1) 
dd(1) 
number(6) 
atof(3C) 
13tol(3C) 
a641(3C) 
convert(1) 
ctime(3C) 
ecvt(3C) 
scanf(3S) 
convert(1) 
strtod(3C) 
strtol(3C) 
byteorder(3N) 
dd(1) 
bcopy(1M) 
epio(1) 
dcopy(1M) 
voleopy(1M) 
ep(1) 
rep(1N) 
uuep(1C) 
uuto(1C) 
uucico(1M) 
core(4) 
core(4) 
trig(3M) 
sinh(3M) 
sum(1) 
we(1) 


in and out. 

archive. 

preprocessor. 

shell environment at/ 
files in binary/ 

clock: report 

craps: the game of 
craps. 

images. 

or rewrite an existing/ 
tmpnam, tempnam: 
rewrite an/ creat: 
fork: 

ctags: 

tmpfile: 
communication. socket: 
channel. pipe: 

SCCS files. admin: 
the manual. catman: 
umask: set and get file 


file. 

crontab - user 
generate C program 
optimization/ curses: 
generate hashing/ 
interpreter) with/ 


remote terminal. 

file. 

name for terminal. 
gmtime, asctime, tzset:/ 
software. 

execution. uux: CTIX to 
config: configure a 

uucp: CTIX system to 
system copy. uucp: 
print name of current 
get name of current 
command execution. uux: 
uuto, uupick: public 
debugger. 

computer system. 

ttt, 

uname: print name of 
uname: get name of 
gethostname: get name of 
editing/ sact: print 

in the utmp file of the 
getcwd: get path-name of 
handling and/ 
interpolate smooth 

login name of the user. 
fields of each line of/ 

of each line of a/ cut: 
constant-width text for/ 
program/ 
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cpio: copy file archives .. 
cpio: format of cpio ... 
cpp: the C language ... 
cprofile: settingup aC .. 
cpset: install object ... 
CPU time used. 
craps. 
craps: the gameof ... . 
crash: examine system . . 
creat: create a new file .. 
create a name fora/ ... 
create a new fileor ... 
create a new process. eo . 
create a tags file. . 2... 
create a temporary file. . 
create an endpoint for .. 
create an interprocess . . 
create and administer . . 
create the cat files for .. 
creation mask. ..... 
cron: clock demon. ... 
crontab - user crontab .. 
crontab file. 
cross-reference. cxref: .. 
CRT screen handling and 

crypt, setkey, encrypt: .. 
esh: a shell (command . . 
esplit: context split. ... 
ct: spawn getty toa ... 
ctags: create atags . . 
ctermid: generate file . 
ctime, localtime, . . . . 
ctinstall: install 
CTIX remote command 

CTIX system. . 2... 
CTIX system copy. ... 
CTIX system to CTIX .. 
CTIX system. uname: . . 
CTIX system. uname: . . 
CTIX to CTIX remote .. 
CTIX-to-CTIX system file/ 
ctrace: C program .... 
cu: call another 
cubic: tic-tac-toe. . ... 
current CTIX system. .. 
current CTIX system. .. 
current host. 
current SCCS file .... 
current user. /the slot . . 
current working/ .... 
curses: CRT screen ... 
curve. spline: 
cuserid: get character .. 
cut: cut out selected ... 
cut out selected fields .. 
ew, checkew: prepare .. 
exref: generateC .... 
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epio(1) 
cpio(4) 
epp(1) 
eprofile(4) 
cpset(1M) 
clock(3C) 
craps(6) 
craps(6) 
crash(1M) 
creat(2) 
tmpnam(3S) 
creat(2) 
fork(2) 
ctags(1) 
tmpfile(3S) 
socket(2N) 
pipe(2) 
admin(1) 
catman(1) 
umask(2) 
cron(1M) 
crontab(1) 
crontab(1) 
exref(1) 
curses(3X) 
ery pt(3C) 
esh(1) 
esplit(1) 
ct(1C) 
ctags(1) 
ctermid(3S) 
ctime(3C) 
ctinstall(1) 
uux(1C) 
config(1M) 
uucp(1C) 
uucp(1C) 
uname(1) 
uname(2) 
uux(1C) 
uuto(1C) 
ctrace(1) 
cu(1C) 
ttt(6) 
uname(1) 
uname(2) 
gethostname(3N) 
sact(1) 
ttyslot(3C) 
getewd(3C) 
curses(3X) 
spline(1G) 
cuserid(3S) 
cut(1) 
cut(1) 
ew(1) 
exref(1) 


runacct: run 

from node/ setaddr: set 
Transfer Protocol/ ftpd: 
server. telnetd: 

/user interface to the 
Transfer/ tftpd: 
/special functions of 
/special functions of the 
command; report process 
terminal capability 
terminal capability 
generate disk accounting 
access long integer 

lock process, text, or 
prof: display profile 
system call. stat: 

brk, sbrk: change 

types: primitive system 
join: relational 

the mkfs(1) proto file 
tput: query terminfo 
/asctime, tzset: convert 
date: print and set the 
date. 


for optimal access/ 

file. 

adb: absolute 

ctrace: C program 
fsdb: file system 

sdb: symbolic 

a remote system with 
neqn. /special character 
basename, dirname: 

a file. tail: 
commentary of an SCCS 
SCCS/ delta: make a 
SCCS/ cde: change the 
rmdel: remove a 
(change) to an SCCS/ 
comb: combine SCCS 
cron: clock 

errdemon: error-logging 
the error-logging 

mesg: permit or 
nroff/troff, tbl, and/ 
system: system 

close: close a file 
duplicate an open file 
de: 

/sldetach: attach and 
of afile. access: 
preprocessor/ includes: 
file: 

drivers: loadable 

for finite width output 
table. master: master 
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daily accounting. 
DARPA Internet address 

DARPA Internet File . . 
DARPA TELNET protocol 


runacct(1M) 


» setaddr(1NM) 
. ftpd(INM) 
. telnetd(INM) 


DARPA TFTP protocol. . . tftp(1N) 
DARPA Trivial File . . . . tftpd(1NM) 
DASI 300 and 300s/ . . . - 300(1) 
DASI 450 terminal. . .. . 450(1) 
data and system/ /time a - timex(1) 
data base. termcap: . . . . termcap(4) 
data base. terminfo: . ... terminfo(4) 
data by user ID. .....- diskusg(1M) 
data in a/ sputl, sgetl: . . . sputl(3X) 
data in memory. plock: . . plock(2) 
Gata | 6: oS ite ce a 28 prof(1) 
data returned by stat . . . stat(5) 
data segment space/ . .. ~ brk(2) 
data types. «2... eee - types(5) 
database operator. . . . . ~ join(1) 
database. fusing ....- qinstall(1) 
database... . es . + + tput(l) 
date and time to string. . . ctime(3C) 
date. «se ee see - + + date(1) 
date: print and set the . . . date(1) 

de: desk calculator. ... ~ de(1) 
dcopy: copy file systems . . dcopy(1M) 
dd: convert and copya ... dd(1) 
debugger. ...... © adb(l) 
debugger. . 2... «+ ctrace(1) 
debugger. ... 2... fsdb(1M) 
debugger. ..... + sdb(l) 
debugging on. /contact . . Uutry(1M) 
definitions for eqn and . . ~ eqnchar(5) 
deliver portions of path/ . . basename(1) 
deliver the last part of . . ~ tail(1) 
delta. /change the delta . . cde(1) 
delta (change) toan ... . delta(1) 
delta commentary of an. . cde(1) 
delta from an SCCS file. . . rmdel(1) 
delta: make adelta .. . . delta(1) 
deltas. . 2... ee ++ + comb(l) 
demon. .....- oe - cron(1M) 
demon. . 2 ee eee eee errdemon(1M) 
demon. /terminate .. . . errstop(1M) 
deny messages. . . 2 se « mesg(1) 
deroff: remove ... +. - deroff(1) 
description file. ... . .» « system(4) 
descriptor. ..... - + « close(2) 
descriptor. dup: .... dup(2) 
desk calculator. . 2... « de(1) 
detach serial lines as/ - slattach(INM) 
determine accessibility . . . access(2) 
determine C language . . . includes(1) 
determine file type. . . . ~ file(1) 
device drivers. ... . . ~ drivers(7) 
device. /fold long lines . . . fold(1) 
device information . . . . « master(4) 
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ioctl: control 

devnm: 

/tekset, td: graphical 
file for uucp/ 


free disk blocks. 
consistency check/ fsck, 
out-going terminal line/ 
calling protocols. 

bdiff: big 

comparator. 

differential file/ 

sdiff: side-by-side 

files. diffmk: mark 
comparator. diff: 

diff3: 3-way 

between files. 
directories. 

comparison. 

uucheck: check the UUCP 
object files in binary 
dir: format of 

rmdir: remove files or 
ed: change working 
chdir: change working 
chroot: change root 
uucleanup: uucp spool 
diremp: 

unlink: remove 

chroot: change root 
make a lost+found 

of current working 

Is: list contents of 
mkdir, mkdirs: make a 
mvdir: move a 

pwd: working 

or/ mknod: make a 
portions of/ basename, 
LP printers. enable, 
acct: enable or 

modes, speed, and line 
modes, speed, and line 
sadp: 

user/ diskusg: generate 
report number of free 
remove exchangeable 
disk: general 

driver. 

Ethernet address on 
update: provide 

du: summarize 
accounting data by user/ 
mount, umount: mount and 
exchangeable disk. 
/screen-oriented (visual) 
prof: 

on local/ ruptime: 
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device. 
device name. 
device routines and / 


eae eee seis 


ee we ee 


Devices: configuration .. 


devnm: device name. . . 
df: report number of . . 
dfsck: file system 
dial: establish an ... 
Dialers: ACU/modem 

diff. 
diff: differential file 
diff3: 3-way . 


difference program. ... 


differences between 
differential file 
differential file/ 
diffmk: mark differences 
dir: format of ..... 
diremp: directory ... 


ioctl(2) 


« devnm(1M) 
- gdev(iG) 


Devices(5) 
devnm(1M) 


. df(1M) 


fsck(1M) 


. dial(3C) 
- Dialers(5) 
. bdiff(1) 
. diff(1) 


diff'3(1) 
sdiff(1) 


. diffmk(1) 


diff(1) 
diff'3(1) 


. diffmk(1) 
- dir(4) 
. diremp(1) 


directories and/ ... . . . uucheck(1M) 
directories. /install . . . . cpset(1M) 
directories. . ..... . « dir(4) 
directories. rm, . . .. + ~ rm(l) 
directory. ..-.2.e.e- ed(1) 
directory. ......-. ~ chdir(2) 
directory. .. +. +. chroot(2) 
directory clean-up. . . . . uucleanup(1M) 
directory comparison. . . . dircmp(1) 
directory entry. . . . . . - unlink(2) 
directory for a command. . . chroot(1M} 
directory for fsck. . . . . . mklost+found(1M) 
directory. /path-name . . . getewd(3C) 
directory, .. . «e+. Is(1) 
directory. .. +. +... mkdir(1) 
directory. ...... +. mydir(1M) 
directory name. ..... . pwd(1) 
directory, or a special . . . mknod(2) 
dirname: deliver . . . . . . basename(1) 
disable: enable/disable . . . enable(1) 
disable process/ . - + . + « acct(2) 
discipline. /type, . - » + - getty(1M) 
discipline. /type, .. . . + uugetty(1M) 
disk access profiler. . . . . sadp(1M) 
disk accounting data by . . diskusg(1M) 
disk blocks. df: ... . . . df(1M) 
disk. dismount: . . . . . - dismount(1) 
disk driver. . . » « « « » « disk(7) 
disk: general disk ... . . disk(7) 
disk. setenet: write . . . . setenet(1NM) 
disk synchronization. . . . update(IM) 
disk usage. . . - - +. du(l) 
diskusg: generate disk . . . diskusg(1M) 


dismount file system. . 
dismount: remove 
display editor based on/ 
display profile data. .. 
display status of nodes 
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- mount(1M) 
- dismount(1) 
. vi(1) 

- prof(1) 


ruptime(1N) 


hypot: Euclidean 
generate uniformly 
/checkmm: print/check 
package for formatting 
and/ mmt, mvt: typeset 
chargefee, ckpacct, 
whodo: who is 

/atof: convert string to 
ptdl: RS-232 terminal 
lrand48, nrand48, / 
graph: 

arithmetic: provide 
Xylogics 772/ xmset: set 
disk: general disk 

sxt: pseudo-device 
make a loadable 
drivers: loadable device 
/manage loadable 
drvbind: access loadable 
drivers. 

access loadable/ 
drivers. drvalloc, 
bcheckre, rc, powerfail, 
usage. 

parts of an object/ 
status information from 
and ascii file 

od: octal 

an object file. dump: 
file descriptor. 
descriptor. dup: 

echo: 


convert floating-point / 


program. end, etext, 
(variant of ex for/ 
print current SCCS file 
/(visual) display 

ed, red: text 

ex: text 

files. Id: link 

ged: graphical 
assembler and link 
sed: stream 

for casual/ edit: text 
Ideeprom: load 

/user, real group, and 
/getegid: get real user, 
FORTRAN, ratfor, or 
file for a/ grep, 
enable/disable LP/ 
process/ acct: 

enable, disable: 
hashing/ crypt, setkey, 
generate hashing 
locations in program. 
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distance function, . 2... « hy pot(3M) 
distributed/ /lcong48: - drand48(3C) 
documents formatted with/ . mm{(1i) 
documents. /the MM macro mm({5) 
documents, view graphs, - mmt(1) 
dodisk, lastlogin/ ... +. acctsh(1M) 
doing what. ... . + + « whodo(1M) 
double-precision number. . . strtod(3C) 
download. tdl, gtd], . .. . tdl(1) 
drand48, erand48, ..... drand48(3C) 
draw agraph. .... +s. graph(1G) 
drill in number facts. . . . arithmetic(6) 
drive parameters for . .. . xmset(1M) 
driver, 2 ee eee eee disk(7) 
driver. 2 2 ee ee © © « © 8xt(7) 
driver for tunable variables. © mktunedrv(1M) 
drivers, «ee eee eee drivers(7) 
drivers. «6 2 «© « « © « « Iddrv(1M) 
drivers. drvalloc, ..... Iddrv(2) 
drivers: loadable device . . drivers(7) 
drvalloc, drvbind: . . . . . Iddrv(2) 
drvbind: access loadable . . Iddrv(2) 
drvload: system/ bre, . ~~ bre(1M) 
du: summarize disk .... du(1) 
dump: dump selected .. . dump(1) 
dump. /error records and . errdead(1M) 
dump. hd: hexadecimal . . hd(1) 
dump. «+ +e eee ee od(l) 
dump selected parts of . . . dump(1) 
dup: duplicate an open . . . dup(2 
duplicate an open file ... ae} 
echo arguments. . . - «~~ echo(1) 
echo: echo arguments. . . . echo(1) 
ecvt, fevt, gevt: . 2... . ecvt(3C) 
ed, red: text editor. ... . ed(1) 
edata: last locations in . . . end(3C) 
edit: text editor ..... . edit(1) 
editing activity. sact: . . . sact(1) 
editor based on ex. «~~ & Vi(1) 
editor, . + +. eee eee ed(l) 
editor, 2 «6 ee ee © © © ex(l) 
editor for common object . . Id(1) 
editor, . 6 + 2 eee «© ged(1G) 
editor output. /eommon . . a.out(4) 
editor, . «+ s+ + « + © © sed(l) 
editor (variant of ex... . edit(1) 
EEPROM. .... «+ «+ « ~ Ideeprom(1M) 
effective group IDs. .. . . getuid(2) 
effective user, real/ .. . » getuid(2) 
efl files. /split ..... . fsplit(1) 
egrep, fgrep: search a - « grep(1) 
enable, disable: . . . - enable(1) 
enable or disable ... . - acct(2) 


enable/disable LP/ . 
encrypt: generate .. 
encryption. /encrypt: 
end, etext, edata: last 
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- enable(1) 


ery pt(3C) 


- crypt(3C) 


end(3C) 


/getgrnam, setgrent, 
host entry. /sethostent, 
/getnetbyname, setnetent, 
socket: create an 
protocol/ /setprotoent, 
/getpwnam, setpwent, 
entry. /setservent, 
/pututline, setutent, 
Arabic numerals to 
niist: get 

linenum: line number 
man, manprog: print 
/macros for formatting 
/manipulate line number 
a/ /seek to line number 
a/ /seek to relocation 
wtmp: utmp and wtmp 
get group file 

get network host 
endnetent: get network 
get protocol 

get password file 
endservent: get service 
access utmp file 

object file symbol table 
/index of a symbol table 
/an indexed symbol table 
write password file 
unlink: remove directory 
command execution. 
environment. 

/setting up a C shell 
profile: setting up an 
environ: user 

execution. env: set 
getenv: return value for 
change or add value to 
inteface, and terminal 
definitions for 
nroff/troff, tbl, and 
format mathematical / 
character definitions/ 
rhosts: remote 
nrand48,/ drand48, 

td: graphical/ hpd, 
function and/ 
complementary/ erf, 
interface. 

records and status/ 
demon. 

format. 

sys_nerr:/ perror, 

erf, erfe: 

/and complementary 
/sys_nerr: system 

/to system calls and 
errdead: extract 
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endgrent, fgetgrent: get/ . 
endhostent: get network . 
endnetent: get network/ . 
endpoint for/ .....- 
endprotoent: get 
endpwent, fgetpwent: get / 
endservent: get service .. 
endutent, utmpname:/ . . 
English. /convert 
entries from name list. .. 
entries in acommon/ . . 
entries in this manual. . . 
entries in this manual. .. 
entries of acommon/ . . 
entries of a section of .. 
entries of a section of .. 
entry formats. utmp, .. 
entry. /fgetgrent: .... 
entry. /endhostent: .. . 
entry. /setnetent, .... 
entry. /endprotoent: .. 
entry. /fgetpwent: ... 
entry. /setservent, .. . 
entry. /utmpname: ... 
entry. /name for common 

entry of a common object / 
entry of a common object / 
entry. putpwent: 
entry. 
envy: set environment for . 
environ: user 
environment at login/ .. 
environment at login/ .. 
environment. 
environment for command 
environment name. ... 
environment. putenv: .. 
environment. /terminal . 
eqn and neqn. /character 

eqn constructs. /remove . 
eqn, neqn, checkeq: ... 
eqnchar: special 
equivalent users. .... 
erand48, lrand48, 
erase, hardcopy, tekset, . 
erf, erfc: error... 2... 
erfe: error function and = . 
err: error-logging 
errdead: extract error. . 
errdemon: error-logging . 
errfile: error-log file ... 
errno, sys_errlist, .... 
error functionand/ ... 
error function. ....- 
error messages. . «+. - 
error numbers. 
error records and status/ . 


oe we 


oe ee © we we we 


a © e eo 


oe ew eee 
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getgrent(3C) 
gethostent(3N) 
getnetent(3N) 
socket(2N) 
getprotoent(3N) 
getpwent(3C) 
getservent(3N) 
getut(3C) 
number(6) 
nlist(3C) 
linenum(4) 
man(1) 

man(5) 
Idlread(3X) 
Idiseek(3X) 
Idrseek(3X) 
utmp(4) 
getgrent(3C) 
gethostent(3N) 
getnetent(3N) 
getprotoent(3N) 
getpwent(3C) 
getservent(3N) 
getut(3C) 
ldgetname(3X) 
ldtbindex(3X) 
Idt bread(3X) 
putpwent(3C) 
unlink(2) 
env(1) 
environ(5) 
eprofile(4) 
profile(4) 
environ(5) 
env(1) 
geteny(3C) 
puteny(3C) 
tset(1) 
eqnchar(5) 
deroff(1) 
eqn(1) 
eqnchar(5) 
rhosts(4N) 
drand48(3C) 
gdev(1G) 
erf(3M) 
erf(3M) 

err(7) 
errdead(1M) 
errdemon(1M) 
errfile(4) 
perror(3C) 
erf(3M) 
erf(3M) 
perror(3C) 
intro(2) 
errdead(1M) 


matherr: 

errfile: 

errdemon: 

errstop: terminate the 
err: 

a report of logged 
hashcheck: find spelling 
of logged errors. 
error-logging demon. 
terminal line/ dial: 
setmnt: 

loadable drivers. 
locations in/ end, 
disk. setenet: write 
function. hypot: 
expression. expr: 

test: condition 

/text editor (variant of 


display editor based on 
crash: 

dismount: remove 
regions of a/ locking: 
execve, execlp, execvp:/ 
execvp:/ execl, execy, 
/execv, execle, execve, 
command. path: locate 
execve, execlp, execvp: 
/argument list(s) and 
later time. at, batch: 
regex: compile and 
requests. uuxqt: 
environment for command 
sleep: suspend 

sleep: suspend 

monitor: prepare 

remote shell command 
rexecd: remote 

profil: 

to CTIX remote command 
execlp, execvp:/ execl, 
execl, execy, execle, 
/execle, execve, execlp, 
system/ link, unlink: 

a new file or rewrite an 
process. 

process. exit, 

sqrt: exponential, / 
unpack: compress and 
and/ expand, unexpand: 
tabs to spaces, and/ 
advent: 

/log, 10g10, pow, sqrt: 

as an expression. 

match/ regexp: regular 
regcemp: regular 

evaluate arguments as an 
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error-handling function. . 
error-log file format. . . . 
error-logging demon. . . . 
error-logging demon. .. . 
error-logging interface. . . 
errors. errpt: process. . 
errors. /spellin, . ... 
errpt: process areport .. 
errstop: terminate the .. 
establish an out-going . . 
establish mount table. . . 
Iddrv: manage ..... 
etext, edata: last .... 
Ethernet address on ... 
Euclidean distance . . . . 
evaluate arguments as an . 
evaluation command. .. 
ex for casual users). . . . 
ex: text editor, ..... 
ex. /(visual) . 2... 
examine system images. . 
exchangeable disk. . . .. 
exclusive access to . . 1. 
execl, execv, execle, ... 
execle, execve, execlp, .. 
execlp, execvp: execute/ . 
executable filefor .... 
execute a file. /execle, . . 
execute command. ... « 
execute commands ata . 
execute regular/ regemp, . 
execute remote command . 
execution. eny:set .. .~ 
execution foran/ .... 
execution for interval. . . 
execution profile. .... 
execution. remd: .... 
execution server. «+ « « « 
execution time profile. . . 
execution. uux: CTIX .. 
execy, execle, execve, « . . 
execve, execlp, execvp:/. 
execyp: execute afile. . . 
exercise link and unlink . 
existing one. /create . .. 
exit, _exit: terminate . . . 
exit: terminate ..... 
exp, log, logl0, pow, ... 
expand files. /peat, ... 
expand tabs to spaces, . . 
expand, unexpand: expand 
explore Colossal Cave. . . 
exponential, logarithm,/ . 
expr: evaluate arguments . 
expression compile and . . 
expression compile. .. - 
expression. eXpr:  - . . e 
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matherr(3M) 
errfile(4) 
errdemon(1M) 
errstop(1M) 
err(7) 
errpt(1M) 
spell(1) 
errpt(1M) 
errstop(1M) 
dial(3C) 
setmnt(1M) 
Iddrv(1M) 
end(3C) 
setenet(INM) 
hy pot(3M) 
expr(1) 
test(1) 
edit(1) 

ex(1) 

vi(1) 
crash(1M) 
dismount(1) 
locking(2) 
exec(2) 
exec(2) 
exec(2) 
path(1) 
exec(2) 
xargs(1) 
at(1) 
regemp(3X) 
uuxqt(1M) 
env(1) 
sleep(1) 
sleep(3C) 
monitor(3C) 
remd(1N) 
rexecd(1NM) 
profil(2) 
uux(1C) 
exec(2) 
exec(2) 
exec(2) 
link(1M) 
creat(2) 
exit(2) 
exit(2) 
exp(3M) 
pack(1) 
expand(1) 
expand(1) 
advent(6) 
exp(3M) 
expr(1) 
regexp(5) 
regemp(1) 
expr(1) 


and execute regular 
strings in C/ xstr: 
and status/ errdead: 
strings in a/ strings: 
floor, ceil, fmod, 
factor: 


values. true, 

in a machine-independent 
fine: 

/mallopt, mallinfo: 

abort: generate an IOT 
flush a stream. 


options. 

floating-point / ecvt, 
fopen, freopen, 

stream status/ ferror, 
fileno: stream status/ 
and statistics for a/ 
stream. felose, 

getc, getchar, 
/setgrent, endgrent, 
/setpwent, endpwent, 
a stream. gets, 

@ pattern. grep, egrep, 
modification/ utime: set 
Idfen: common object 
accessibility of a 

tar: tape 

out. cpio: copy 

grpck: password/group 
chmod: change mode of 
owner and group of a 
diff: differential 

3-way differential 

fentl: 

fentl: 

rep: remote 
CTIX-to-CTIX system 
format of core image 
umask: set and get 
crontab - user crontab 
ctags: create a tags 
fields of each line of a 
using the mkfs(1) proto 
dd: convert and copy a 
(change) to an SCCS 
close: close a 

dup: duplicate an open 
type. 

hexadecimal and ascii 
parts of an object 

sact: print current SCCS 
fgetgrent: get group 
fgetpwent: get password 
utmpname: access utmp 
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expression. /compile .. . 


extract and share 
extract error records . . 


extract the ASCII text .. 


fabs: floor, ceiling,/ 
factor a number. 
factor: factor a number. 
false: provide truth . . 
fashion.. /integer data . 
fast incremental backup. 
fast main memory/ 
fault. 
fclose, fflush: close or 
fentl: file control. 
fentl: file control 
fevt, gevt: convert ... 


regemp(3X) 
xstr(1) 


- errdead(1M) 


strings(1) 


- floor(3M) 


factor(1) 
factor(1)} 
true(1) 
sputl(3X) 


- fine(1M) 


fdopen: open astream. ... 


feof, clearerr, fileno: . 
ferror, feof, clearerr, . 
ff: list filenames .. 
fflush: close or flush a 

fgetc, getw: get / 
fgetgrent: get group/ 


.. ff(1M) 


. Seal 


malloc(3X) 
abort(3C) 
felose(3S) 


fentl(5) 
ecvt(3C)} 
fopen(3S) 
ferror(3S) 
fe oe ) 


- felose(3S) 


fgetpwent: get password/ . . 
fgets: get a string from . . 


fgrep: search afile for . 
file access and 
file access routines. . 
file. access: determine 
file archiver. 
file archives in and 
file checkers. pwck, 
file. 
file. chown: change 
file comparator. 
file comparison. diff3: 
file control. 
file control options. 
file copy. 
file copy. /public . 
file. core: 
file creation mask. . 
file. 
file. 
file. /cut out selecte 
file database. /software 
file. 
file. /make a delta 
file descriptor. 
file descriptor. 
file: determine file .. . 
filedump. hd: ... 
file. /dump selected 
file editing activity. . 
file entry. /endgrent, 
file entry. /endpwent, 


. 
. 
. 
. 

oe 

ee 

oe ee ee we ew 
ee 

ee ee 

. 
oe © © @ 

oe ee 8 


ee ee se we ee 


es © © © © © @ © © 8B 


file entry. /endutent, .. 
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getc(3S) 
getgrent(3C) 
getpwent(3C) 
gets(3S) 


+ grep(1) 


ee © © © © we ew we 


utime(2) 
ldfen(4) 
access(2) 
tar(1) 
epio(1) 
pwek(1M) 
chmod(2) 
chown(2) 
diff(1) 
diff3(1) 


- fentl(2) 
- fenti(5) 


rep(1N) 


- uuto(1C) 


core(4) 
umask(2) 


- crontab(1) 


ctags(1) 
eut(1) 


+ qinstall(1) 


dd(1) 


- delta(1) 


close(2) 


- dup(2) 


file(1) 
hd(1) 


- dump(1) 


sact(1) 


- getgrent(3C) 
- getpwent(3C) 


getut(3C) 


putpwent: write password 
execvp: execute a 

/egrep, fgrep: search a 
path: locate executable 
/open a common object 
Devices: configuration 
per-process accounting 
ar: common archive 
errfile: error-log 

intro: introduction to 

of a common object 

get a version of an SCCS 
group: group 

object files. filehdr: 
Idfhread: read the 

/seek to the optional 
split: split a 

issue identification 

a member of an archive 
close a common object 
of a common object 

of a common object 

of a common object 

of a common object 

of a common object 

of a common object 
entry of a common object 
entry of a common object 
table of a common object 
in a common object 
link: link to a 

file;/ qlist: print out 
access to regions of a 

an ifile from an object 
mknod: build special 

or a special or ordinary 
ctermid: generate 
mktemp: make a unique 
statistics/ ff: list 

the format of a text 

list of common object 
null: the null 

/the slot in the utmp 

/ processes using a 

creat: create a new 
passwd: password 
subsequent lines of one 
soft-copy/ pg: 

/ftell: reposition a 

Iseek: move read/write 
prs: print an SCCS 
read: read from 

for a common object 

a delta from an SCCS 
bfs: big 

two versions of an SCCS 
scesfile: format of SCCS 
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fileentry, ....-++-2-. putpwent(3C) 
file. /execve, execlp, . . . . exec(2) 

file for a pattern. . 2... grep(1) 

file for command. ..... path(1) 

file for reading. ...... ldopen(3X) 
filefor uucp/ 2... ..- Devices(5) 
file format. acct: 2... acct(4) 
fileformat. ........ ar(4) 
fileformat. ....... . errfile(4) 
file formats. . 2... ee intro(4) 

file function. /entries . . . Idlread(3X) 
file. get: . - 2. 2 2 2 « « get(l) 

file. . «ee ee es + - « group(4) 
file header for common . . . filehdr(4) 
file header of acommon/ . . Idfhread(3X) 
file header of acommon/ . . Idohseek(3X) 
file into pieces. ... .. « split(1) 

file. issue: «6 2 ee ee issue(4) 

file. /archive header of . . Idahread(3X) 
file. /Idaclose: . 2... Idclose(3X) 
file. /the file header . . . - Idfhread(3X) 
file. /ofasection ....- Idiseek(3X) 
file. /fileheader ..... Idohseek(3X) 
file. fof asection ... . . Idrseek(3X) 
file. /section header . . . . Idshread(3X) 
file. /section . ... . + © Idsseek(3X) 
file. /ofasymbol table . . Idtbindex(3X) 
file. /symbol table . . . - Idtbread(3X) 
file. /to the symbol .. . . Idtbseek(3X) 
file. /number entries . . . linenum(4) 
file... ee ee ee ee © link(2) 

file lists from proto... - qlist(1) 

file. /exclusive ... . . » locking(2) 
file. mkifile: make . . . . . mkifile(1M) 
file. 2. 6 2 2. 2 2 + e © ~ mknod(1M) 
file. /make a directory, - mknod(2) 
file name for terminal. . . . ctermid(3S) 
filename. ....... - mktemp(3C) 
filenamesand .....- ff(1M) 

file. newform: change . . . newform(1) 
file. nm: print name . .. . nm(1) 

file. 2 eee eee evene null(7) 

file of the current/ .. . . ttyslot(3C) 
file or file structure. . . . . fuser(1M) 
file or rewrite an/ ... . - creat(2) 
file. . 2... ...+... ~ passwd(4) 
file. /several files or . . . + paste(1) 

file perusal filter for .. . . pg(1) 

file pointer ina/ .... . fseek(3S) 
file pointer. . . . . « + « « Iseek(2) 

file, 2. eee ee we © © prs(l) 

file. . 2 6 6 6 ee © © © © read(2) 
file. /information .. . « « reloc(4) 

file. rmdel: remove... + rmdel(1) 
filescanner. ... . . + + bfs(1) 

file. scesdiff: compare . . . scesdiff(1) 
files. 67a se: vis, 228i 0, so te - scesfile(4) 
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for a common object 
/file lists from proto 
fsize: report 

i-node. openi: open a 
stat, fstat: get 

ASCII text strings in a 
from a common object 
/using a file or 

and block count of a 
synchronous write on a 
/name for common object 
syms: common object 
check and/ fsck, dfsck: 
fsdb: 

and statistics for a 

fs: 

mkfs: construct a 
mount and dismount 
mount: mount a 

ustat: get 

mnttab: mounted 
umount: unmount a 
system description 
access/ dcopy: copy 
by/ checklist: list of 
volcopy, labelit: copy 
the last part of a 
format of compiled term 
create a temporary 

a name for a temporary 
modification times of a 
ftp: 

ftpd: DARPA Internet 
tftpd: DARPA Trivial 
ftw: walk a 

file: determine 

TZ: time zone 

previous get of an SCCS 
repeated lines in a 

and Permissions 

val: validate SCCS 
write: write on a 
umask: set 

common object files. 
ferror, feof, clearerr, 
print process accounting 
or add total accounting 
and administer SCCS 
concatenate and print 
cmp: compare two 
common to two sorted 
my: copy, link or move 
mark differences between 
header for common object 
find: find 

catman: create the cat 
tape. frec: recover 
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file. /section header . . 
file; set links based/ . . 
file size. 
file specified by .... 
file status. 
file. /extract the ... 
file. /information ... 
file structure. 
file. /print checksum 
file. swrite: 
file symbol] table entry. 
file symbol table/ 
file system consistency 
file system debugger. 
file system. /file names 


file system format. eh she 


file system. 
file system. /umount: 
file system. 
file system statistics. 


file system table. . 2... 


file system. 
file. system: 
file systems for optimal 
file systems processed . 
file systems with label / 
file. tail: deliver . . .. 
file.. term: 
file. tmpfile: 
file. /tempnam: create . 
file. /update access and 
file transfer program. . 
File Transfer Protocol / 
File Transfer Protocol / 
file tree. 
file type. 
file. 2 2 eee eee 
file. unget: undoa . 
file. uniq: report .. 
file. /UUCP directories 
file. 
file. 
file-creation mode mask. 
filehdr: file header for 
fileno: stream status/ 
file(s). /search and. 
files. acctmerg: merge 
files. admin: create . 
files. cat: 
files. 
files. 
files. 
files. 
files. 
files. 
files for the manual. 
files from a backup 


ee ea eee 


eee we @ 8 


/or reject lines 
cp, In, 
diffmk: ... 
filehdr: file . 
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senhdr(4) 


- glist(1) 


fsize(1) 


- openi(2) 
- stat(2) 

. strings(1) 
- strip(1) 


fuser(1M) 


- sum(1) 


swrite(2) 


- Idgetname(3X) 


syms(4) 
fsck(1M) 
fsdb(1M) 


. ff(1M) 


fs(4) 


- mkfs(1M) 


mount(1M) 
mount(2) 


- ustat(2) 


mnttab(4) 


+ umount(2) 
. system(4) 


dcopy(1M) 
checklist(4) 
volcopy(1M) 
tail(1) 
term(4) 
tmpfile(3S) 
tmpnam(3S) 
touch(1) 
ftp(1N) 
ftpd(1NM) 
tftpd(1NM) 
ftw(3C) 


- file(1) 


t2(4) 
unget(1) 
uniq(1) 


- uucheck(1M) 


val(1) 
write(2) 


- umask(1) 
. filehdr(4) 


ferror(3S) 


- acctcom(1) 


acctmerg(1M) 


- admin(1) 


cat(1) 
emp(1) 
comm(1) 
ep(1) 
diffmk(1) 
filehdr(4) 
find(1) 


- catman(1) 


frec({1M) 


specification in text 
ratfor, or efl 

format of graphical 
cpset: install object 
preprocessor include 
introduction to special 
editor for common object 
lockf: record locking on 
rm, rmdir: remove 
/same lines of several 
compress and expand 
pr: print 

sizes of common object 
sort: sort and/or merge 
/object and archive 
what: identify SCCS 
pg: file perusal 

greek: select terminal 
nl: line numbering 
line-feeds. col: 

device routines and 
tplot: graphics 

backup. 

find: 


hyphen: 

ttyname, isatty: 

for an object/ lorder: 
/spellin, hashcheck: 
utmp file of / ttyslot: 
/fold long lines for 
fish: play “‘Go 


tee: pipe 

/convert ASCII string to 
/fevt, gevt: convert 
/manipulate parts of 
floor, ceiling,/ 

floor, ceil, fmod, fabs: 
cflow: generate C 

fclose, fflush: close or 
ceiling,/ floor, ceil, 

for finite width output / 
finite width/ fold: 
open a stream. 

process. 

accounting file 

ar: common archive file 
errfile: error-log file 

fs: file system 

for/ eqn, neqn, checkeq: 
newform: change the 


inode: 

file... term: 
file. core: 
cpio: 

dir: 
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files. fspec: format . .. « fspec(4) 
files. /split FORTRAN, . . fsplit(1) 
files. /string, .... 2... gps(4) 
files in binary/ ... . . « cpset(1M) 
files. /C language .. 2... includes(1) 
files. intro: . 2. eee » + intro(7) 
files. Id: link 2 2... Id(1) 
flea 2 aie sb hte eet lockf(3C) 
files or directories. . . . . - rm(1) 
files or subsequent/ .. - - paste(1) 
files. /peat, unpack: . . . . pack(1) 
files. . 2 2 2 ee ee ee © pr(l) 
files. /print section .. . - size(1) 
files. . 2 2 2 6 © ee © © © Sort(l) 
files to common formats. . . convert(1) 
files, 2. 2 ee ee © © © © Wwhat(1) 
filter for soft-copy/ . . + + pg(l) 
filter. . 2 2 2 ee eee © greek(l) 
1) nl(1) 
filter reverse... . + + col(1) 
filters. /td: graphical . . . gdev(1G) 
filters. . 2 2 2 2 6 6 «© « tplot(1G) 
fine: fast incremental . . . finc(1M) 
find files. . 2... find(l) 
find: find files. ... . .. find(1) 
find hyphenated words. . . hyphen(1) 
find name of a terminal. . . ttyname(3C) 
find ordering relation .~ . « lorder(1) 
find spelling errors. . ~~» « spell(1) 
find the slotin the . . . « ttyslot(3C) 
finite width output/ ... . fold(1) 
Risk. co ue wee «an fh (G) 
fish: play “Go Fish”. . . . fish(6) 
fitting. . 2. 2 2 2 2 eo « tee(l) 
floating-point number. . . . atof(3C) 
floating-point number to/ . eevt(3C) 
floating-point numbers. . . frexp(3C) 
floor, ceil, fmod, fabs: . . . floor(3M) 
floor, ceiling,/ . . . . + + « floor(3M) 
flowgraph. ... +--+ ¢flow(1) 
flush a stream. ... . « » fclose(3S) 
fmod, fabs: floor, .. . + « floor(3M) 
fold: fold long lines + + » fold(1) 
fold long lines for. . «~~ fold(1) 
fopen, freopen, fdopen: . . . fopen(3S) 
fork: createa new . . «+ © fork(2) 
format. /per-process .. ~ acct(4) 
format. . 2. 6 +e «+ ar(4) 
format. . +... + errfile(4) 
format. «+. + «++ fs(4) 
format mathematical text . eqn(1) 
format of a text file. . . . . newform(1) 
format of an i-node. .. . « inode(4) 
format of compiled term . term(4) 
format of core image . . . . core(4) 
format of cpio archive. . . - cpio(4) 
format of directories. . . . dir(4) 
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/ primitive string, 
secsfile: 

text files. fspec: 

object file symbol table 
or troff. tbl: 

nroff: 

archive files to common 
introduction to file 

utmp and wtmp entry 
fscanf, sscanf: convert 
varargs/ /vsprintf: print 
/fprintf, sprintf: print 
/print/check documents 
/the macro package for 
/the MM macro package for 
this/ man: macros for 
management. netman: 
efl/ fsplit: split 
hopefully interesting, / 
formatted/ printf, 

putc, putchar, 

stream. puts, 
input/output. 

a backup tape. 

df: report number of 
main memory/ malloc, 
mallopt,/ malloc, 
stream. fopen, 
manipulate parts of / 
frec: recover files 

/line number information 
/receive a message 

get character or word 
fgets: get a string 
mkifile: make an ifile 
rmdel: remove a delta 
/get option letter 

and status information 
read: read 

ncheck: generate names 
nlist: get entries 
DARPA Internet address 
acctcms: command summary 
/print out file lists 
getpw: get name 


formatted input. scanf, 
systems processed by 

make a lost+found directory for 
consistency check and/ 
debugger. 

reposition a file/ 


specification in text/ 
ratfor, or efl files. 

stat, 

pointer/ fseek, rewind, 


5/86 


format of graphical/ . . 


format of SCCS file. . 2... 
- fspec(4) 
- syms(4) 


format specification in . 
format. syms: common 
format tables for nroff 
format text. 
formats. /object and . 
formats. intro: 
formats. utmp, wtmp: 
formatted input. scanf, 
formatted output of a 
formatted output. 
formatted with the MM/ 
formatting a permuted/ 
formatting documents. 
formatting entriesin . . 
form-based network . . 


FORTRAN, ratfor, or .. 


fortune: print a random, 
fprintf, sprintf: print . . 
fputc, putw: put/ 
fputs: put a string on a 
fread, fwrite: binary . 
frec: recover files from 
free disk blocks. 
free, realloc, calloc: 
free, realloc, calloc, 
freopen, fdopen: open 
frexp, ldexp, modf: 
from a backup tape. .. 
from a common object / 
from a socket. 
from a stream. /getw: 
from a stream. gets, . 
from an object file. . 


“pee 


from an SCCS file. 1... 


from argument vector. 

from dump. /records  . 
from file. 
from i-numbers. 
from name list. 
from node name. /set 


from per-process/ .. . « 


from proto file; set/ . . 
from UD. .. 
fs: file system format. . 
fscanf, sscanf: convert 

fsck. /list of file ... 
fsck. iy Sa fe 
fsck, dfsck: file system . 


fsdb: file system ..... 


fseek, rewind, ftell: . . 
fsize: report file size. . . 
fspec: format ..... 
fsplit: split FORTRAN, 

fstat: get file status. . . 


ftell: reposition a file . .. 
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gps(4) 
scesfile(4) 


tbl{1) 
nroff(1) 
convert(1) 


- intro(4) 


utmp(4) 


- scanf(3S) 
- vprintf(3S) 


printf(3S) 


- mm(1) 


mptx(5) 
mm(5) 


- man(5) 


netman(1NM) 
fsplit(1) 
fortune(6) 


- printf(3S) 


pute(3S) 
puts(3S) 


. fread(38S) 


frec(1M) 


. df(1M) 
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malloc(3C) 
malloc(3X) 
fopen(3S) 
frexp(3C) 
frec(1M) 
strip(1) 
recv(2N) 
getc(3S) 
gets(3S) 
mkifile(1M) 
rmde}(1) 
getopt(3C) 


. errdead(iM) 


read(2) 
ncheck(1M) 


- nlist(3C) 


setaddr(1NM) 


- acctems(1M) 


qlist(1) 


- getpw(3C) 
- fs(4) 


scanf(3S) 
checklist(4) 


+ mklost+found(1M) 


fsck(1M) 
fsdb(1M) 


- fseek(3S) 


fsize(1) 


- fspec(4) 
. fsplit(1) 


stat(2) 
fseek(3S) 


interprocess/ 
program. 
File Transfer Protocol/ 


/shut down part of a 
erf, erfe: error 

and complementary error 
gamma: log gamma 
Euclidean distance 

of a common object file 
matherr: error-handling 
prof: profile within a 
math: math 

jn, yO, yl, yn: Bessel 
power, square root 
absolute value 

ocurse: optimized screen 
/300s: handle special 
hp: handle special 

450/ 450: handle special 
cosh, tanh: hyperbolic 
atan2: trigonometric 
processes using a file/ 
input/output. fread, 
manipulate connect/ 
moo: guessing 

back: the 

bj: the 

craps: the 

wump: the 

trk: trekkie 

intro: introduction to 
gamma: log 

function. 

ecvt, fevt, 


maze: 
abort: 

cflow: 

cross-reference. cxref: 
data by user/ diskusg: 
terminal. ctermid: 
crypt, setkey, encrypt: 
i-numbers. neheck: 
simple lexical/ lex: 
/seed48, lcong48: 
simple random-number 
stream. gets, fgets: 
file. get: 

getsockopt, setsockopt: 
ulimit: 

of the user. cuserid: 
/getchar, fgetc, getw: 
list. nist: 

umask: set and 

stat, fstat: 

statistics. ustat: 
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ftok: standard .... 
ftp: file transfer . ... 
ftpd: DARPA Internet . 
ftw: walk a file tree. . . 
full-duplex connection. . 
function and/ ..... 
function. /function .. 
function. 
function. hypot: ... 
function. /entries ... 
function. 
function. 
functions and constants. 
functions. j0, jl, ... 
functions. /logarithm, . 
functions. /remainder, . 
functions. 
functions of DASI 300/ 
functions of HP 2640 and/ 
functions of the DASI . 
functions. sinh, 
functions. /acos, atan, . 
fuser: identify . .... 
fwrite: binary 
fwtmp, wtmpfix: ... 
game. 
game of backgammon. . 
game of black jack. .. 
game of craps. 
game of hunt-the-wumpus. 
game. 
games. 
gamma function. ... 
gamma: log gamma .. 
gevt: convert/ 
ged: graphical editor. . 
generate a maze. owe 
generate an IOT fault. . 
generate C flowgraph. . 
generate C program .. 
generate disk accounting 
generate file name for . 
generate hashing/ .. . 
generate names from . . 
generate programs for . 
generate uniformly/ . . 
generator. rand, srand: 
getastringfroma .. 
get a version of an SCCS 
get and set options on/ 
get and set user limits. . 
get character login name 
get character or word/ . 
get entries from name . 
get file creation mask. . 
get file status. .... 
get filesystem ...-. 
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stdipe(3C} 
ftp(1N) 
ftpd(1NM) 
ftw(3C) 
shutdown(2N} 
erf(3M) 
erf(3M) 
gamma(3M) 
hy pot(3M) 
Idlread(3X) 
matherr(3M) 
prof(5) 
math(5) 
bessel(3M) 
exp(3M) 
floor(3M) 
ocurse(3X) 
300(1) 

hp(1) 

450(1) 
sinh(3M) 
trig(3M) 
fuser(1M) 
fread(3S) 
fwtmp(1M) 
moo(6) 
back(6) 
bj(6) 
craps(6) 
wump(6) 
trk(6) 
intro(6) 
gamma(3M) 
gamma(3M) 
ecvt(3C) 
ged(1G) 
maze(6)} 
abort(3C) 
cflow(1) 
exref(1) 
diskusg(1M) 
ctermid(3S) 
ery pt(3C) 
ncheck(1M) 
lex(1) 
drand48(3C) 
rand(3C) 
gets(3S) 
get(1) 
getsockopt(2N} 
ulimit(2) 
cuserid(3S) 
getc(3S) 
nlist(3C) 
umask(2) 
stat(2) 
ustat(2) 


on 


SCCS file. 

/endgrent, fgetgrent: 
getlogin: 

logname: 

msgget: 

getpw: 

peer. getpeername: 
system. uname: 

host. gethostname: 
/setnetent, endnetent: 
/sethostent, endhostent: 
unget: undo a previous 
argument/ getopt: 
/endpwent, fgetpwent: 
working/ getcwd: 
process times. times: 
/getpgrp, getppid: 
/endprotoent: 

user,/ /getgid, getegid: 
/setservent, endservent: 
semget: 

segment. shmget: 
getsockname: 

terminal. tty: 

time: 

getw: get character or/ 
get character or/ getc, 
current working/ 
getuid, geteuid, getgid, 
environment name. 
getegid: get/ getuid, 
real/ getuid, geteuid, 
getgrnam, setgrent, / 
setgrent,/ getgrent, 
getgrent, getgrgid, 
gethostent, 
/gethostbyaddr, 
gethostbyaddr,/ 
current host. 

name. 

getnetent, 

getnetent, getnetbyaddr, 
getnetbyname,/ 

letter from argument/ 
options. 

password. 

connected peer. 
process,/ getpid, 
getppid: get process, / 
getpid, getpgrp, 
/getprotobynumber, 
getprotoent, 
getprotobynumber,/ 
UD. 

getpwnam, setpwent,/ 
getpwent, getpwuid, 
setpwent,/ getpwent, 
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get: get aversion of an .. 
get group file entry. .. . 
get loginname. ..... 
get loginname. ..... 
get message queue. eee 
get name from UID. ... 
get name of connected .. 
get name of current CTIX 
get name of current ... 
get network entry. 
get network host entry. . 
get of an SCCS file. ... 
get option letter from .. 
get password file entry. . 
get path-name of current . 
get process and child .. 
get process, process/ ... 
get protocol entry. . ... 
get real user, effective .. 
get service entry. .... 
get set of semaphores. .. 
get shared memory ... 
get socket name. . 2... 
get the name ofthe ... 
get time. 
getc, getchar, fgetc, ... 
getchar, fgetc, getw: . .. 
getcwd: get path-name of 
getegid: get real user,/ . 
getenv: return value for 
geteuid, getgid, .... 
getgid, getegid: get. . 
getgrent, getgrgid, . .. 
getgrgid, getgrnam, .. 
getgrnam, setgrent,/ .. 
gethostbyaddr,/ .... 
gethostbyname,/ ... 
gethostent, 
gethostname: get name of 
getlogin: get login 
getnetbyaddr,/ 
getnetbyname, setnetent, / 
getnetent, getnetbyaddr, . 
getopt: get option 
getopt: parse command =. 
getpass: read a 
getpeername: get name of 
getpgrp, getppid: get .. 
getpid, getpgrp, 
getppid: get process,/ .. 
getprotobyname,/ .... 
getprotobynumber,/ ... 
getprotoent, 
getpw: get name from . 
getpwent, getpwuid, ... 


oe ee ew we 8 


“2 ew oe 


getpwnam, setpwent,/ 
getpwuid, getpwnam, 
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get(1) 
getgrent(3C) 
getlogin(3C) 
logname(1) 
msgget(2) 
getpw(3C) 
getpeername(2N) 
uname(2) 
gethostname(3N) 
getnetent(3N) 
gethostent(3N) 
unget(1) 
getopt(3C) 
getpwent(3C) 
getcwd(3C) 
times(2) 
getpid(2) 
getprotoent(3N) 
getuid(2) 
getservent(3N) 
semget(2) 
shmget(2) 
getsockname(2N) 
tty(1) 

time(2) 

getc(3S) 
getc(3S) 
getcwd(3C) 
getuid(2) 
geteny(3C) 
getuid(2) 


- getuid(2) 


getgrent(3C) 
getgrent(3C) 
getgrent(3C) 
gethostent(3N) 
gethostent(3N} 
gethostent(3N) 
gethostname(3N) 
getlogin(3C) 
getnetent(3N) 
getnetent(3N) 
getnetent(3N) 
getopt(3C) 
getopt({1) 
getpass(3C) 

get peername(2N) 
getpid(2) 
getpid(2) 
getpid(2) 
getprotoent(3N) 
getprotoent(3N) 
getprotoent(3N) 
getpw(3C) 
getpwent(3C) 
getpwent(3C) 
getpwent(3C) 


string from a stream. 
/getservbyport, 
getservent, 
getservbyport,/ 

name, 

get and set options on/ 
settings used by 

type, modes, speed, and/ 
terminal. ct: spawn 
terminal settings used/ 
getegid: get real user, / 
getutline, pututline,/ 
pututline,/ getutent, 
getutent, getutid, 

getc, getchar, fgetc, 
ctime, localtime, 

fish: play 

longjmp: non-local 
string, format of / 


graph: draw a 

sag: system activity 
graphics: access 
/network useful with 
hardcopy, tekset, td: 
ged: 

/string, format of 

string, format of/ gps: 
contents routines. toc: 
gutil: 

graphical and numerical/ 
tplot: 

plot: 

subroutines. plot: 
/typeset documents, view 
/for typesetting view 
filter. 

search a file for a/ 
/effective user, real 

/get process, process 
chgrp: change owner or 
/endgrent, fgetgrent: get 
group: 


setpgrp: set process 

id: print user and 
group, and effective 
setgid: set user and 
newegrp: log in to a new 
chown: change owner and 
signal to a process or a 
/update, and regenerate 
file checkers. pwcek, 
signals. ssignal, 

/or relocate a PT or 
termina] download. td, 
hangman: 
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gets, fgets: gta... . 
getservbyname,/ ... 
getservbyport,/ .... 
getservent, . 2. 2. e ee 
getsockname: get socke 

getsockopt, setsockopt: . 
getty. fandterminal . 
getty: set terminal . . . 
getty toaremote ... 


gettydefs: speed and ... 


getuid, geteuid, getgid, . 
getutent, getutid, .. . 
getutid, getutline, . . . 
getutline, pututline,/  . 
getw: get character or/ . 
gmtime, asctime, tzset:/ 
“Go Fish”. 
goto. setimp, -...- 
gps: graphical primitive 

graph: draw a graph. . 
graph. 
graph. 
graphical and numerical/ 
graphical commands. . 
graphical device/ /erase, 
graphical editor... .. 
graphical files. .... 
graphical primitive 
graphical table of . 
graphical utilities. . 

graphics: access . . 

graphics filters. . . . 
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graphics interface. 
graphics interface 
graphs, and slides. 
graphs and slides. .. . 
greek: select terminal . 
grep, egrep, fgrep: . 
group, and effective/ . 
group, and parent/ 

group. chown, .. 
group file entry. . . 
group file. 
group: group file. . 
group ID. 
group IDs and names. . 
group IDs. /user, real. 
group IDs. setuid, ... 
group. 
group of a file. 
group of processes. /a . 
groups of programs. . . 
grpck: password/group . 
gsignal: software ... 
GT local printer. .. . 
gtd), ptdl: RS-232 ... 
guess the word. .... 
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gets(3S) 
getservent(3N) 
getservent(3N) 
getservent(3N) 
getsockname(2N) 
getsockopt(2N) 
gettydefs(4) 
getty(1M) 
et(1C) 
getty defs(4) 
getuid(2) 
getut(3C) 
getut(3C) 
getut(3C) 
getc(3S) 
ctime(3C) 
fish(6) 
setjmp(3C) 
gps(4) 
graph(1G) 
graph(1G) 
sag(1G) 
graphics(1G) 
stat(1G) 
gdev(1G) 
ged(1G) 
gps(4) 
gps(4) 
toc(1G) 
gutil(1G) 
graphics(1G) 
tplot(1G) 
plot(4) 
plot(3X) 
mmt(1) 
mv(5) 
greek(1) 
grep(1) 
getuid(2) 
getpid(2) 
chown(1) 
getgrent(3C) 
group(4) 
group(4) 
setpgrp(2) 
id(1) 
getuid(2) 
setuid(2) 
newgrp(1) 
chown(2) 
kill(2) 
make(1) 
pwek(1M) 
ssignal(3C) 
mktpy(1) 
tdl(1) 
hangman(6) 


2 


moo: 

utilities. 

[for Xylogics 772 
processing. shutdown, 
of DASI 300/ 300, 300s: 
of HP 2640 and/ hp: 

of the DASI 450/ 450: 
list. varargs: 

curses: CRT screen 


/run a command immune to 
graphical/ hpd, erase, 
hinv: 

hdestroy: manage 
hashmake, spellin, 
/encrypt: generate 
hashcheck: find/ spell, 
manage hash/ hsearch, 
ascii file dump. 
hsearch, hcreate, 
object/ senhdr: section 
files. filehdr: file 
Idfhread: read the file 
to the optional file 
indexed/named section 
/read the archive 


help: ask for 

file dump. hd: 
inventory. 

/manipulate Volume 
fortune: print a random, 
{convert values between 
endhostent: get network 
get name of current 
network. 

/special functions of 
functions of HP 2640/ 
tekset, td: graphical/ 
hdestroy: manage hash/ 
ntohs: convert values/ 
convert values/ htonl, 
wump: the game of 
sinh, cosh, tanh: 

words. 

hyphen: find 

distance function. 
accounting data by user 
set or shared memory 
IDs and names. 

set process group 

issue: issue 

a file or file/ fuser: 
what: 

id: print user and group 
and parent process 

and effective group 
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guessing game. . 
gutil: graphical 
half-inch tape/  . . 
halt: terminate all 
handle special functions 

handle special functions . 


handle variable argument 
handling and/ 
hangman: guess the word. 
hangups and quits. 


hardware inventory. .. 
hash search tables. .. 
hashcheck: find spelling/ 
hashing encryption. .. 
hashmake, spellin, 
hereate, hdestroy: . . . 
hd: hexadecimal and 
hdestroy: manage hash/ 


header for common object 
header of a common / 
header of a common/ /seek 
header of a common/ /an 
header of a member of an/ 
help: ask for help. 
help. . 2 2 ee ee ee 
hexadecimal and ascii. 
hiny: hardware .... 
Home Blocks (VHB). . . 
hopefully interesting,/ . 
host and network byte/ 
host entry. /sethostent, 
host. gethostname: 
hosts: list of nodes on 
HP 2640 and 2621-series/ 
hp: handle special 
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moo(6) 
gutil(1G) 
xmset(1M) 


- shutdown(1M) 
- 300(1) 
- hp(1) 
handle special functions .. 


450(1) 


- varargs(5) 


curses(3X) 


- hangman(6) 
- nohup(1) 
hardcopy, tekset, itd: . ... 


gdev(1G) 
hinv(1M) 
hsearch(3C) 
spell(1) 


- erypt(3C) 
- spell(1) 


hsearch(3C) 
hd(1) 


- hsearch(3C) 
header foracommon ... 


hpd, erase, hardcopy, ... 
- hsearch(3C) 


hsearch, hcreate, .. 
htonl, htons, ntohl, . 

htons, ntohl, ntohs: .. 
hunt-the-wumpus. .. 

hyperbolic functions. . . 
hyphen: find hyphenated 
hyphenated words. .. 
hypot: Euclidean 
ID. generate disk 


senhdr(4) 
filehdr(4) 
\dfhread(3X) 
Idohseek(3X) 
Idshread(3X) 
Idahread(3X) 
help(1) 

help(1) 

hd(1) 

hinv(1M) 
libdev(3X) 
fortune(6) 
byteorder(3N) 
gethostent(3N) 
gethostname(3N) 
hosts(4N) 
hp(1) 

hp(1) 
gdev(1G) 


byteorder(3N) 
byteorder(3N) 
wump(6) 
sinh(3M) 

hy phen(1) 


- hyphen(1) 
- hypot(3M) 


id. /queue, semaphore ... 
- id(1) 


id: print user and group 
ID. setpgrp: 
identification file. .... 
identify processes using . 
identify SCCS files. 
IDs and names. 


diskusg(1M) 
iperm(1) 


set pgerp(2) 


- issue(4) 


IDs. /process group, . ..- -» 


Ds. /user, real group, 
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fuser(1M) 
what(1) 
id(1) 
getpid(2) 
getuid(2) 


set user and group 
network interface/ 

file. mkifile: make an 
core: format of core 
crash: examine system 
nohup: run a command 
/C language preprocessor 
language preprocessor / 
fine: fast 

/tgoto, tputs: terminal 
formatting a permuted 
Idtbindex: compute the 
ptx: permuted 

entry/ Idtbread: read an 
/ldnshread: read an 

of/ /ldnsseek: seek to an 
inet_ntoa,/ 

Internet/ /inet_makeaddr, 
/inet_network, inet_ntoa, 
address/ /inet_Inaof, 
inet_addr, 

inet_addr, inet_network, 
inittab: script for the 
control initialization. 
telinit: process control 
/drvload: system 
volume. iv: 

a socket. connect: 
process. popen, pclose: 
init process. 

clri: clear 

i-node. 

inode: format of an 

open a file specified by 
blocks associated with 
/start and stop terminal 
convert formatted 

push character back into 
fread, fwrite: binary 
stdio: standard buffered 
fileno: stream status 
uustat: uucp status 
software/ qinstall: 
install: 

commands. 

binary/ cpset: 

or GT/ mktpy, mvtpy: 
ctinstall: 

/set terminal, terminal 
abs: return 

/convert between long 
/sgetl: access long 

atoi: convert string to 
/convert between 3-byte 
3-byte integers and long 
beopy: 

processing/ mailx: 
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IDs. setuid, setgid: .. 
ifconfig: configure .. . 
ifile from an object .. 
image file. 
images. . 2.2 ee ee 
immune to hangups and/ 
include files. 
includes: determine C  . 
incremental backup. 
independent operations. 
index. /package for 
index of a symbol table/ 
INEXs Ses eka ees 
indexed symbol table . 
indexed /named section/ 

indexed/named section . 
inet_addr, inet_network, 
inet_Inaof, inet_netof: . 
inet_makeaddr,/ ... 
inet_netof: Internet 
inet_network, inet_ntoa,/ 
inet_ntoa,/ 2... ees 
init process. 
init, telinit: process .. 
initialization. init, .. . 
initialization shell/ . . 
initialize and maintain . 
initiate a connection on 
initiate pipe to/from a 
inittab: script for the 

i-node. 
inode: format of an . . 
i-node. 
isnode. openi: . .«.. - 
i-node(s). /the list of . 
input and output. 
input. /fscanf, sscanf: . 
input stream. ungetc: . 
input/output. . 2... 
input/output package. . 
inquiries. /clearerr, . 
inquiry and job control. 

install and verify ... 
install commands. ... 
install: install 
install object files in .. 
install or relocate a PT . 
install software. 
inteface, and terminal/ . 
integer absolute value. . 
integer and base-64/ . . 
integer data in a/ 
integer. strtol, atol, . . 
integers and long/ .. - 
integers. /between  . 
interactive block copy. . 
interactive message 
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setuid(2) 
ifconfig(1NM) 
mkifile(1M) 
core(4) 
crash(1M) 
nohup(1) 
includes(1) 
includes(1) 
finc(1M) 
termcap(3X) 
mptx(5) 
Idtbindex(3X) 
ptx(1) 
Idtbread(3X) 
Idshread(3X) 
idsseek(3X) 
inet(3N) 
inet(3N) 
inet(3N) 
inet(3N) 
inet(3N) 
inet(3N) 
inittab(4) 
init(1M) 
init(1M) 
bre(1M) 
iv(1) 
connect(2N) 
popen(3S) 
inittab(4) 
clri(1M) 
inode(4) 
inode(4) 
openi(2) 
beheck(1M) 
rsterm(1M) 
scanf(3S) 
unget¢(3S) 
fread(3S) 
stdio(3S) 
ferror(3S) 
uustat(1C) 
qinstall(1) 
install( 1M) 
install(1M) 
cpset(1M) 
mktpy(1) 
ctinstall(1) 
tset(1) 
abs(3C) 
aB41(3C) 
sputl{3X) 
strtol(3C) 
13tol(3C) 
13tol(3C) 
beopy(1M) 
mailx(1) 


/consistency check and 

/a random, hopefully 

err: error-logging 

qic: 

Ip: parallel printer 

mem, kmem: system memory 
/configure network 

plot: graphics 

plot: graphics 

swap administrative 

termio: general terminal 
terminal accelerator 
protocol. telnet: user 
TFTP/ tftp: user 
controlling terminal 

yme: VME bus 

serial lines as network 

node/ setaddr: set DARPA 
/inet_Inaof, inet_netof: 
Protocol/ ftpd: DARPA 
and numbers for the 
protocols: list of 

services: list of 

curve. spline: 

control/ asa: 

esh: a shell (command 

pipe: create an 

ipes: report 

ftok: standard 

suspend execution for an 
suspend execution for 
commands and/ 

file formats. 

games. 

miscellany. 

special files. 

subroutines and/ 

system calls and error/ 

and application/ intro: 
formats. intro: 

intro: 
intro: 
intro: 
subroutines and/ intro: 
calls and error/ intro: 
generate names from 
hinv: hardware 


miscellany. 
files. 


abort: generate an 
queue, semaphore set or/ 
inter-process/ 

/isdigit, isxdigit, 

islower, isdigit, / 
/isgraph, iscntrl, 
terminal. ttyname, 
/isprint, isgraph, 
/isupper, islower, 
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interactive repair. . .. . 
interesting, adage. . ... 
interface. 
interface for QIC tape. .. 
interface. 
interface. . 2.2. 2. eee 
interface parameters. og 
interface. 
interface subroutines. .. 
interface. swap: . 2. 2.» « 
interface. 
interface. tiop: 
interface to TELNET .. 
interface tothe DARPA . 
interface. tty: 
interface. 
interfaces. /and detach . 
Internet address from 
Internet address/ .... 
Internet File Transfer .. 
internet. /names .... 
Internet protocols. . . .. 
Internet services. . 2... 
interpolate smooth ... 
interpret ASA carriage . . 
interpreter) with C-like/ 


interprocess channel. . . . 
inter-process/ . 2... «. 
interprocess/ . 2.2 2 6 
interval. sleep: ..... 
interval. sleep: 2... .. 
intro: introduction to .. 
intro: introduction to .. 
intro: introduction to .. 
intro: introduction to. . 


introduction to .. 
intro: introduction to .. 
intro: introduction to 
introduction to commands 
introduction to file ... 
introduction to games. . . 
introduction to 
introduction to special .. 
introduction to 
introduction to system . . 
i-numbers. ncheck: ... 
inventory. 
ioctl: control device. . .. 
IOT fault. 
iperm: remove a message . 
ipes: report 
isalnum, isspace,/ ... . 
isalpha, isupper, ..... 
isascii: classify / 
isatty: find nameofa .. 
isentrl, isascii:/ ..... 
isdigit, isxdigit,/ ... . 


intro: 
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fsck(1M) 
fortune(6) 
err(7) 
qie(7) 
1p(7) 
mem(7) 
ifconfig(1NM) 
plot(4) 
plot(3X) 
swap(1M) 
termio(7) 
tiop(7) 
telnet(1N) 
tftp(1N) 
tty(7) 
vme(7) 
slattach(1NM) 
setaddr(1NM) 
inet(3N) 
ftpd(1NM) 
networks(4N} 
protocols(4N) 
services(4N) 
spline(1G) 
asa(1) 
esh(1) 
pipe(2) 
ipes(1) 
stdipe(3C) 
sleep(1) 
sleep(3C) 
intro(1 
nets 
Hee 
intro(5 
7 


intro| 
3 


ncheck(1M) 
hinv(1M) 
ioctl(2) 
abort(3C) 
iperm(1) 
ipes(1) 
etype(3C) 
ctype(3C) 
ctype(3C) 
ttyname(3C) 
ety pe(3C) 
ety pe(3C) 


/ispunct, isprint, 
isalpha, isupper, 
/isspace, ispunct, 
/isalnum, isspace, 
/isxdigit, isalnum, 
system: 

file. issue: 
identification file. 
isdigit,/ isalpha, 
/islower, isdigit, 

news: print news 
maintain volume. 
Bessel functions. 

Bessel functions. j0, 
bj: the game of black 
functions. j0, jl, 
database operator. 
/nrand48, mrand48, 
processes. killall: 
process or a group of/ 
process. 

processes. 

interface. mem, 

quiz: test your 

between 3-byte integers/ 
long integer and/ a64l, 
/copy file systems with 
systems with/ volcopy, 
scanning and processing 
/arithmetic 

cpp: the C 

includes: determine C 
/command programming 
/ckpacct, dodisk, 

shi: shell 

/srand48, seed48, 
common object files. 
object file. ldclose, 
archive header of a/ 
object file for/ Idopen, 
a common object file. 


parts of/ frexp, 

file access routines. 
header of a common/ 
symbol name for common/ 
manipulate/ Idlread, 
Idlread, Idlinit, 

Idlitem: manipulate/ 

to line number entries/ 
number entries/ lIdlseek, 
relocation/ Idrseek, 
Idshread, 
indexed/named/ Idsseek, 
optional file header of/ 
common object file for/ 
to relocation entries/ 
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isgraph, isentrl,/  . . . 2 ctype(3C) 
islower, isdigit,/ ...... cty pe(3C) 
isprint, isgraph,/ ..... ety pe(3C) 
ispunct, isprint,/ .. . . . ctype(3C) 
isspace, ispunct,/ .... cty pe(3C) 
issue a shell command. . . . system(3S) 
issue identification . . ..- issue(4) 
issue: issue . 2 2 ee ee issue(4) 
isupper, islower, . ....- ety pe(3C) 
isxdigit, isalnum,/ . . 2... ety pe(3C) 
items. . 6.6 2 ee ee ee news(1) 

iv: initialize and 2... iv(1) 

jO, jl, jn, yO, yl, yn: . . . . bessel(3M) 
jl, jn, yO, yl,yn: ..... bessel(3M) 
GREEN eos cto Ree . » j(6) 

jn, yO, yl, yn: Bessel . . . . bessel(3M) 
join: relational ...... join(1) 
jrand48, srand48,/ . . .. . drand48(3C) 
kill all active ...... . killall(1M) 
kill: send a signaltoa .. . kill(2) 

kill: terminatea ... .. « kill(1) 
killall: kill all active . . . . killall(1M) 
kmem: system memory . . - mem(7) 
knowledge. . . ~~» «+ © quiz(6) 
I3tol, Itol3: convert. . . « 13tol(3C) 
164a: convert between .. . a641(3C) 
label checking. .. . + » volcopy(1M) 
labelit: copy file . . . . - . voleopy(1M) 
language. awk: pattern . . awk(1) 
language. . 2. 6 «+ « « « be(l) 
language preprocessor. . . - cpp(1) 
language preprocessor/ . . . includes(1) 
language. » . «© + + « « » & Sh(1) 
lastlogin, monacct,/ . . » - acctsh(1M) 
layer manager. «~~ ~~ shi(1) 
lcong48: generate/ . . . . . drand48(3C) 
Id: link editor for ..... 1d(1) 
Idaclose: close a common . .« Idclose(3X) 
Idahread: read the . ... « ldahread(3X) 
Idaopen: open acommon . . Idopen(3X) 


Idclose, Idaclose: close .. .- 
Ideeprom: load EEPROM. . 
ldexp, modf: manipulate .. 
Idfen: common object ... 
Idfhread: read the file ... 
Idgetname: retrieve . .. 
Idlinit, Idlitem: ...... 
Idlitem: manipulate line/ . . 
idlread, Idlinit, 
Idlseek, Idnlseek: seek .. © 
Idnlseek: seek toline . 1. - 


Idnrseek: seek to 2. 2 « e 
Idnshread: read anf ...- 
Idnsseek: seek toan .... 
Idohseek: seek tothe .... 
Idopen, Idaopen: opena .. 
Idrseek, Idnrseek: seek .. . 
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Idclose(3X) 
Ideeprom(1M) 
frexp(3C) 
Idfen(4) 
Idfhread(3X) 
Idgetname(3X) 
Idlread(3X) 
ldlread(3X) 
Idiread(3X) 
Idlseek(3X) 
Idlseek(3X) 
Idrseek(3X) 
Idshread(3X) 
Idsseek(3X) 
Idohseek(3X) 
Idopen(3X) 
idrseek(3X) 


read an indexed/named/ 
to an indexed/named/ 
index of s symbol table/ 
indexed symbol table/ 
symbol table of a/ 
getopt: get option 

for simple lexical / 
programs for simple 
update. Isearch, 

Volume Home Blocks/ 
to subroutines and 
relation for an object 

ar: archive and 

ulimit: get and set user 
/an out-going terminal 
/type, modes, speed, and 
/type, modes, speed, and 
line: read one 

common object/ linenum: 
/\dlitem: manipulate 
/Idniseek: seek to 

strip: strip symbol and 
nl: 

selected fields of each 
/requests to an LP 

Ipset: set parallel 

\pr: 


update. Isearch, Ifind: 
col: filter reverse 

entries in a common/ 
/attach and detach serial 
comm: select or reject 
for uucp communications 
output/ fold: fold long 
head: give first few 

uniq: report repeated 
/files or subsequent 

or/ paste: merge same 
link, unlink: exercise 
object files. Id: 
/common assembler and 


cp, In, my: copy, 

link: 

link and unlink system/ 
from proto file; set 
checker. 

directory. Is: 

statistics for a/ ff: 

get entries from name 
bcheck: print out the 
file. nm: print name 
processed by/ checklist: 
protocols. protocols: 
services. services: 
network. hosts: 
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idshread, ldnshread: .. 
Idsseek, Idnsseek: seek 
Idtbindex: compute the 
\dtbread: read an . .. 


Idtbseek: seek tothe ... 


letter from argument / 
lex: generate programs . 
lexical tasks. /generate 
Ifind: linear search and 


libdev: manipulate . ... 


libraries. /introduction 
library. /find ordering 
library maintainer for / 
limits. 
line connection. 
line discipline. 

line discipline. 


lIdshread(3X) 


- Idsseek(3X) 


Idt bindex(3X) 


- Idtbread(3X) 


ldtbseek(3X) 


« getopt(3C) 


lex(1) 
lex(1) 


- lsearch(3C) 


line. «ee ee ee ew eee 
- linenum(4) 


line number entries in a 
line number entries of a/ 
line number entries of a/ 
line number information/ 
line numbering filter. . 
line of a file. /cut out 
line printer... . 
line printer options. 
line printer spooler. 
line: read one line. . 
linear search and. 
line-feeds. 
linenum: line number 
lines as network/ . . 
lines common to two/ 
lines. /file 
lines for finite width 
lines. 
lines in afile. . 2. 
lines of one file. .. 
lines of several files 
link and unlink system/ 
link editor for common . 
link editor output. . . . 
link: link toafile. . 2. 
link or move files. . . . 
link to a file. 
link, unlink: exercise . 
links based on. /lists 
lint: a C program 
list contents of .. 
list file names and . 
list. nlist: 
list of blocks/ . ... 
list of common object 
list of file systems . . 
list of Internet ... 
list of Internet ... 
list of nodeson ... 


ee e @ wee 


se © 


oe © © © © ee we ew ew ee ew lll 


ee ee 
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libdev(3X) 
intro(3) 
lorder(1) 
ar(1) 
ulimit(2) 
dial(3C) 
getty(1M) 
uugetty(1M) 
line(1) 


Idlread(3X) 
Idlseek(3X) 


- strip(1) 


nl(1) 

eut(1) 

Ip(1) 
Ipset(1M) 
Ipr(2) 
line(1) 
Isearch(3C) 
col(1) 
linenum(4) 
slattach(1NM) 
comm(1) 
Devices(5) 
fold(1) 
head(1) 
uniq(1) 
paste(1) 
paste(1) 


. . dink(1M) 


1d(1) 


- a.out(4) 
- link(2) 


cp(1) 
link(2) 


. link(1M) 


qlist(1) 
lint(1) 
Is(1) 


- ff(1M) 

- nlist(3C) 

- beheck(1M) 
- nm(1) 


checklist(4) 


- protocols(4N) 


services(4N) 


- hosts(4N) 


by terminal/ ttytype: 
uuname: 

handle variable argument 
of a varargs argument 
on a socket. listen: 
connections on a/ 
/construct argument 
qlist: print out file 
move files. cp, 
Ideeprom: 

drivers: 

mktunedrv: make a 
lddrv: manage 
drvbind: access 
asctime, tzset:/ ctime, 
as the/ conlocate: 

for command. path: 
end, etext, edata: last 
data in memory. plock: 
files. 

access to regions of a/ 
lockf: record 

gamma: 

newgrp: 

exponential,/ exp, 
exponential,/ exp, log, 
/pow, sqrt: exponential, 
uulog: output 

process a report of 
network. rwho: who is 
getlogin: get 

logname: get 

cuserid: get character 
logname: return 
passwd: change 

rlogin: remote 

rlogind: remote 


aC shell environment at 
up an environment at 


name of user. 

/\64a: convert between 
sputl, sgetl: access 
3-byte integers and 
width output/ fold: fold 
set}mp, 

relation for an object / 
make a 

nice: run a command at 
requests to an LP line/ 
/requests to an 
interface. 

disable: enable/disable 
/|Ipmove: start/stop the 
reject: allow/prevent 
lpadmin: configure the 


5/86 


list of terminal types . . . . ttytype(4) 
list UUCP system names. . . uuname(1C) 
list. varargs: . ... .. . varargs(5) 
list. /formatted output . . vprintf(3S) 
listen for connections . . . listen(2N) 
listen: listen for... . . « listen(2N) 
list(s) and execute/ . . . . xargs(1) 
lists from proto file;/ . . . qlist(1) 

In, mv: copy, link or . . . . ep({l) 

load EEPROM. ... .. ~ Ideeprom(1M) 
loadable device drivers. . . drivers(7) 
loadable driver for/ .. . . mktunedrv(IM) 
loadable drivers. .. » ~ - Iddrv(1M) 
loadable drivers. ... . - Iddrv(2) 
localtime, gmtime, . . . . . ctime(3C) 
locate a terminal to use . . conlocate(iM) 
locate executable file . . . . path(1) 
locations in program. .. . end(3C) 
lock process, text, or . . . . plock(2) 
lockf: record locking on . . lockf(3C) 
locking: exclusive .. . . - locking(2) 
locking on files. . . . . © + lockf(3C) 
log gamma function. . . . - gamma(3M) 
log in to a new group. . . . newgrp(1) 
log, log10, pow, sqrt: . . . . exp(3M) 
1ogl0, pow, sqrt: .. +. « exp(3M) 
logarithm, power, square/ - exp(3M) 
logfile information. .. . - uulog(1C) 
logged errors. errpt: . . . . errpt(1M) 
logged in on local... . « rwho(1N) 
login name. . . . « « « » © getlogin(3C) 
login name. . . . . » + « « logname(l) 
login name of the user. . . . cuserid(3S) 
login name of user. . . . ~ logname(3X) 
login password. ... . ~~ passwd(1) 
login. . . «2 2 eo « © © © rlogin(1N) 
login server, . +. + ~ « rlogind(INM) 
login: sign on. . . . » « « © login(1) 
login time. /setting up - - - eprofile(4) 
login time. /setting . .. ~ profile(4) 
logname: get login name. . . logname(1) 
logname: return login . . . logname(3X) 
long integer and base-64/ . a641(3C) 
long integer dataina/ . . . sputl(3X) 
long integers. /between .~ . I3tol(3C) 
long lines for finite .. . . fold(1) 
longjmp: non-local goto. . . setjmp(3C) 
lorder: find ordering . . . ~ lorder(1) 
lost+found directory for fsck mklost+found(1M) 
low priority. ... . +. ~ nice(1) 

Ip, cancel: send/cancel . . © Ip(1) 

LP line printer. . . 2... - Ip(1) 

Ip: parallel printer . . . . ~ Ip(7) 

LP printers. enable, . . . . enable(1) 
LP request scheduler and/ . Ipsched(1M) 
LP requests. accept, . . . . accept(1M) 
LP spooling system. . .. . Ipadmin(1M) 
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ipstat: print 

LP spooling system. 
LP/ Ipsched, Ipshut, 
spooler. 

start/stop the LP/ 
printer options. 
start/stop the/ Ipsched, 
information. 

drand48, erand48, 
directory. 

search and update. 
file pointer. 

3-byte integers/ 3tol, 


values. values: 

/long integer data in a 
formatting a/ mptx: the 
formatting/ mm: the MM 
typesetting/ mv: a troff 
m4: 

entries in this/ man: 
formatted with the MM 
mail to users or read 

to users or read mail. 
mail. mail, rmail: send 
message processing/ 
/free, realloc, calloc: 
/mallopt, mallinfo: fast 
regenerate groups/ make: 
iv: initialize and 

ar: archive and library 
an SCCS file. delta: 
mkdir, mkdirs: 

special or/ mknod: 
mktunedrv: 
mklost+found: 
mktemp: 

object file. mkifile: 

and regenerate groups/ 
mk hosts: 

banner: 

terminal/ script: 
memory/ /calloc, mallopt, 
calloc: main memory / 
calloc, mallopt,/ 

/free, reailoc, calloc, 
formatting entries in/ 
entries in this manual. 
/tfind, tdelete, twalk: 
/hcereate, hdestroy: 
Iddrv: 

form-based network 
window: window 

wm: window 

shi: shell layer 

fwtmp, wtmpfix: 
/ldlinit, Idlitem: 
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LP status information. 
Ipadmin: configure the 


Ipmove: start/stop the . . . !psched(1M) 
Ipr: line printer . 2... © Ipr({i) 
Ipsched, Ipshut, Ipmove: . Ipsched(1M) 
Ipset: set parallel line . . ~ Ipset(1M) 
Ipshut, lpmove: . . .. + « Ipsched(1M) 
Ipstat: print LP status - « Ipstat(1) 
lrand48, nrand48,/. . . . . drand48(3C) 
Is: list contents of . ... . Is(1) 

\search, Ifind: linear... © Isearch(3C) 
Iseek: move read/write .. . Iseek(2) 
Itol3: convert between . . . I3tol(3C) 

m4: macro processor. .. . m4(1) 
machine-dependent .. . . values(5) 
machine-independent/ . . . sputl(3X) pe 
macro package for . . . . . mptx(5) 
macro package for . . . . . mm(5) 
macro package for . . . . . mv(5) 

macro processor. .... . m4(1) 
macros for formatting .. . man(5) 
macros. /documents . .. . mm(I1) 

mail. mail, rmail: send . . . mail(1) 

mail, rmail: send mail . . . mail(1) 
mail to users or read . . - ~ mail(1) 
mailx: interactive . . .. . mailx(1) 
main memory allocator. . . malloc(3C) 
main memory allocator. . . malloc(3X) 
maintain, update, and .. . make(1) 
maintain volume. . . .. . iv(1) 
maintainer for portable/  . . ar(1 
make a delta (change) to . . delta(1) 
make a directory. . .. . . mkdir(1) 
make a directory, ora .. » mknod(2) | 
make a loadable driver/ . . mktunedrv(1M) | 
make a lost+found directory/ mklost+found(1M) | 
make a unique file name. . . mktemp(3C) 
make an ifile from an . . . mkifile(1M) 
make: maintain, update, . . make(1) 
make node name commands. mkhosts(1NM) 
make posters. . . 2... banner(1) 
make typescript of . . . . script(1) 
mallinfo: fast main . . - . malloc(3X) 
malloc, free, realloc, . . . . malloc(3C) 
malloc, free, realloc, . . » . malloc(3X) 
mallopt, mallinfo: fast / + malloc(3X) 
man: macros for . . . . » . man(5) 

man, manprog: print . . . . man(1) 
manage binary search/ . . . tsearch(3C) 
manage hash search/ . . . hsearch(3C) 
manage loadable drivers. . . Iddrv(1M) 
management. netman: . . . netman(1NM) 
management primitives. - window(7) 
management. . -.. ... wm(L) 
manager. . «+--+ «~~ shi(l) 
manipulate connect/ . . . . fwtmp(1M) 
manipulate line number/ . . Idlread(3X) 
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. Ipstat(1) 
- . lpadmin(1M) 


frexp, ldexp, modf: 
tables. route: manually 
Blocks (VHB). libdey: 
/Internet address 

in this manual. man, 
the cat files for the 
print entries in this 
entries in this 

routing tables. route: 
terminal input/ rsterm: 
set. ascii: 

files. diffmk: 

set file-creation mode 
and get file creation 
information/ master: 
information table. 
expression compile and 
constants. math: 
constants. 

/neqn, checkeq: format 
function. 


maze: generate a 

vax: provide truth/ 
interface. 

memcpy, memset: memory / 
memset: memory/ memcecpy, 
memory/ memecpy, memcehr, 
memecpy, memchr, memcmp, 
Tealloc, calloc: main 
/mallinfo: fast main 

shmetl: shared 

semaphore set or shared 
mem, kmem: system 
/memcmp, memepy, memset: 
shmop: shared 

text, or data in 

shmget: get shared 

memchr, mememp, memepy, 
sort: sort and/or 
accounting/ acctmerg: 
several files or/ paste: 
messages. 

operations. msgctl: 
/recvfrom: receive a 

msgop: 

mailx: interactive 

Insgget: get 

set or/ ipcrm: remove a 
send, sendto: send a 

mesg: permit or deny 
sys_nerr: system error 
directory. 

directory. mkdir, 

system. 

/software using the 
commands. 
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manipulate parts off . . . . 
manipulate the routing ... 
manipulate Volume Home. 
manipulation routines. ... 
manprog: print entries . . . 
manual. catman: create .. 
manual. man, manprog: . . 
manual. /for formatting . . 
manually manipulate the . . 
manually start and stop . . 
map of ASCII character .. 
mark differences between . . 
mask. umask: 
mask. umask: set .. 2+. 
master device . 2. 2. 2 ess 
master: master device .. . 
match routines. /regular . . 
math functionsand ... .» 
math: math functions and . 
mathematical text for/ .. . 
matherr: error-handling . . 
maze: generate a maze. . . . 
MAZEL. © esos: cee ue Ure yet ees es 
mc68k, pdpll, u3b, u3b5, sk. 
mem, kmem: system memory 
memccpy, memchr, mememp, 
memchr, memcmp, memepy, 

mememp, memepy, memset: 

memepy, memset: memory / 

memory allocator. /free, . . 
memory allocator. . . « « « 
memory control/ 
memory id. /queue, .... 
memory interface. .. 2. 
memory operations. .... 
memory operations. .... 
memory. /lock process, . . 
memory segment. . . « « « 
memset: memory/ memcepy, 
merge files. . 2 2 2 ee ee 
merge or add total 
merge same linesof .... 
mesg: permit or deny ... 
message control . .. +s... 
message from a socket. . . . 
message operations. ... . 
message processing/ ... - 
message queue. 
message queue, semaphore . 
message to a socket. . . . « 
messages. . 2 2 2 ee ew 
messages. /sys_errlist, . . - 
mkdir, mkdirs: makea ... 
mkdirs: makea .....- 
mkfs: construct afile ... 
mkfs(1) proto file/ ..... 
mkhosts: make node name. 


es 2 ee me 


ee e ewe 


frexp(3C) 
route(1NM) 
libdev(3X) 
inet(3N) 
man(1) 
catman(1) 
man(1) 
man(5) 
route(1NM) 
rsterm(1M) 
ascii(5) 
diffmk(1) 
umask(1) 
umask(2) 
master(4) 
master(4) 
regexp(5) 
math(5) 
math(5) 
eqn(1) 
matherr(3M) 
maze(6) 
maze(6) 
machid(1) 
mem(7) 
memory(3C) 
memory(3C) 
memory(3C} 
memory(3C) 
malloc(3C) 
malloc(3X) 
shmctl(2) 
iperm(1) 
mem(7) 
memory(3C) 
shmop(2) 
plock(2} 
shmget(2) 
memory(3C) 
sort(1) 
acctmerg(1M) 
paste(1) 
mesg(1) 
msgctl(2)} 
recv(2N) 
msgop(2) 
mailx(1) 
msgget (2) 
iperm(1) 
send(2N) 
mesg(1) 
perror(3C) 
mkdir(1) 
mkdir(1) 
mkfs(1M) 
qinstall(1) 
mkhosts(INM) 


from an object file. 
lost+found directory / 
file. 

or a special or/ 

file name. 

relocate a PT or GT/ 
driver for tunable/ 
formatting/ mm: the 
formatted with the 
print/check documents/ 
for formatting/ 
documents, view graphs, / 
system table. 

chmod: change 

umask: set file-creation 
chmod: change 

/set terminal type, 

/set terminal type, 

of/ frexp, ldexp, 

touch: update access and 
/set file access and 
/dodisk, lastlogin, 
execution profile. 
uusub: 


perusal. 

mount: 

system. mount, umount: 
system. 

setmnt: establish 
dismount file system. 
table. mnttab: 

mvdir: 

In, my: copy, link or 
pointer. lseek: 

LP request scheduler and 
for formatting a/ 
/lrand48, nrand48, 
operations. 

queue. 

operations. 

package for typesetting/ 
files. cp, In, 


view graphs, and/ mmt, 
relocate a PT or/ mktpy, 
from i-numbers. 
mathematical text/ eqn, 
definitions for eqn and 
network management. 
status. 

/values between host and 
/endnetent: get 
/endhostent: get 

hosts: list of nodes on 
ifconfig: configure 

detach serial lines as 
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mkifile: make an ifile ... 
mklost+found: makea ... 
mknod: build special . . . . 
mknod: make a directory, . 
mktemp: make a unique . . 
mktpy, mvtpy: install or .. 
mktunedrv: make a loadable 

MM macro package for. . 
MM macros. /documents . 
mm, osdd, checkmm: blgecs 
mm: the MM macro package 


mmt, mvt: typeset . . 2... 
mnttab: mounted file ... 
mode. . 2.2. ee ee ee 
mode mask. ...2...-. 


mode of file. 
modes, speed, and line/ . . 
modes, speed, and line/ . . 
modf: manipulate parts .. 
modification times of a/ . . 
modification times. ... » 
monacct, nulladm,/ .... 
monitor: prepare . 2... 
monitor uucp network. ... 
moo: guessing game. . .. « 
more, page: text . « « + « « 
mount a file system. . ... 
mount and dismount file .. 
mount: mountafile .... 
mount table. 
mount, umount: mount and 

mounted file system .... 
move a directory. .. 
move files. cp, 
move read/write file . 
move requests. /the .... 
mptx: the macro package . . 
mrand48, jrand48,/ .... 
meget: message control .. 
msgget: get message . ... 
msgop: message .....- 
my:atroff macro ..... 
my: copy, link or move ... 
mvdir: move a directory. . 
myt: typeset documents, . 
mvtpy: install or 
neheck: generate names’. 
neqn, checkeq: format ... 
neqn. /special character . . 
netman: form-based ... 
netstat: show network .. 
network byte order. . .. 
network entry. 
network host entry. ... 
network. 
network interface/  . .. . 
network interfaces. /and . 


. 
ere et ee 
. 
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mkifile(1M) 
mklost+found(1M} 
mknod(1M) 
mknod(2) 
mktemp(3C) 
mktpy(1) 
mktunedry(1M) 
mm(5) 

mm(1) 

mm(1) 

mm(5) 
mmt(1) 
mnttab(4) 
chmod(1) 
umask(1) 
chmod(2) 
getty(1M) 
uugetty(1M) 
frexp(3C) 
touch(1) 
utime(2) 
acctsh(1M) 
monitor(3C) 
uusub(1M) 
moo(6) 
more(1) 
mount(2) 
mount(1M) 
mount(2) 
setmnt(1M) 
mount(1M) 
mnttab(4) 

my dir(1M) 
cp(1) 

Iseek(2) 
Ipsched(1M) 
mptx(5) 
drand48(3C) 
msgctl(2) 
msgget(2) 
msgop(2) 
my(5) 

cp(1) 
mvdir(1M) 
mmt(1) 
mktpy(1) 
ncheck(1M) 
eqn(1) 
eqnchar(5) 
netman(1NM) 
netstat(1N) 
byteorder(3N) 
getnetent(3N) 
gethostent(3N) 
hosts(4N) 
ifeonfig(1NM) 
slattach(1NM) 


netman: form-based 
status of nodes on local 
is logged in on local 
netstat: show 

stat: statistical 
uucpd: 

uusub: monitor uuep 
numbers for the/ 
format of a text file. 
group. 

news: print 


a process. 
process by changing 

low priority. 

filter. 

name list. 

common object file. 
mkhosts: make 

Internet address from 
rwhod: 

/display status of 

hosts: list of 

immune to hangups and/ 
setjmp, longjmp: 
/erand48, lrand48, 


mathematical text for 
tbl: format tables for 
eqn/ deroff: remove 
values/ htonl, htons, 
htonl, htons, ntohl, 
null: the 


/lastlogin, monacct, 

nl: line 

number: convert Arabic 
/access graphical and 

to/ convert: convert 
routines. Idfen: common 
selected parts of an 
/Idaopen: open a common 
/entries of a common 
Idaclose: close a common 
file header of a common 
of a section of a common 
file header of a common 
of a section of a common 
header of a common 
/section of a common 
table entry of a common 
table entry of a common 
symbol table of a common 
entries in a common 
make an ifile from an 
name list of common 
information for a common 
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network management. ... 


network. /display 


network. rwho: who .. . 


network status. 
network useful with/ 
network uucp server. 
network. . 
networks: names and . 


newform: change the... 


newegrp: log in to a new 
news items. 
news: print news items. 

nice: change priority of . 


netman(1NM) 
ruptime(1N) 


- rwho(1N) 


netstat(1N) 


- stat(1G) 
+ uucpd(1NM) 


nice. /ofrunning ....- 
- nice(1) 


nice: run a command at 
nl: line numbering 
nlist: get entries from 
nm: print name list of 


node name commands. .. .« 


node name. /set DARPA 


node status server. .. 


nodes on local network. 


nodes on network. . ... » 


nohup: run a command 
non-local goto. 
nrand48, mrand48,/ . 
nroff: format text. 
nroff or troff. /format 
nroff or troff. . ... 
nroff/troff, tbl, and. 
ntohl, ntohs: convert . 
ntohs: convert values/ 
null file. 
null: the null file. . . 
nulladm, pretmp,/ . . 


ee 


ee ee ew ew 


numbering filter. . 

numerals to English. 

numerical commands. 
object and archive files . 
object file access 
object file. dump: dump 
object file for reading. 
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uusub(1M) 
networks(4N) 
newform(1) 
newgrp(1) 
news(1) 
news(1) 
nice(2) 
renice(1) 


nl(1) 

nlist(3C) 
nm(1) 
mkhosts(1NM) 
setaddr(1NM) 
rwhod(INM) 
ruptime(1N) 
hosts(4N) 
nohup(1) 
setjmp(3C) 
drand48(3C) 
nroff(1) 
eqn(1) 

tbl(1) 
deroff(1) 
byteorder(3N) 
byteorder(3N) 
null(7) 

null(7) 
acctsh(1M) 
ni(1)} 
number(6) 
graphics(1G) 
convert(1) 
ldfen(4) 


ie 


- dump(i) 


object filefunction. .... 


Idclose, .. 
/readthe . 
fentries . . 
/optional . 
/entries .. 


object file. 
object file. 
object file. 
object file. 
object file. 
object file. 
object file. 
object file. 
object file. 
object file. 
object file. 
object file. 
object file. 
object file. 


/number . . 


nm: print 
/relocation . 
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Idopen(3X) 
Idlread(3X) 
Idclose(3X) 
Idfhread(3X) 
Idiseek(3X) 


- Idohseek(3X) 


/section . . «+ 
/asymbol ... 
/symbol ... 
/tothe .... 


mkifiles .... 


Idrseek(3X) 
Idshread(3X) 
Idsseek(3X) 
ldtbindex(3X) 
Idtbread(3X) 
ldtbseek(3X) 
linenum(4) 
mkifile(1M) 
nm(1) 


- reloc(4) 


header for a common 
/from a common 
/symbol name for common 
format. syms: common 
file header for common 
epset: install 

link editor for common 
section sizes of common 
ordering relation for an 
od: 

functions. 


file/ Idopen, Idaopen: 
i-node. openi: 

fopen, freopen, fdopen: 
dup: duplicate an 
writing. open: 

or writing. 

specified by i-node. 
profiler. prf: 

/prfde, prfsnap, prfpr: 
memepy, memset: memory 
msgctl: message control 
msgop: message 
semaphore control 
semop: semaphore 
shared memory control 
shmop: shared memory 
strespn, strtok: string 
terminal independent 
relational database 
/copy file systems for 
/CRT screen handling and 
functions. ocurse: 
argument/ getopt: get 
a/ \dohseek: seek to the 
fentl: file control 

stty: set the 

getopt: parse command 
parallel line printer 
/setsockopt: get and set 
object/ lorder: find 
/or a special or 
print/check/ mm, 

dial: establish an 

and link editor 

lines for finite width 
information. uulog: 
/print formatted 
sprintf: print formatted 
stop terminal input and 
and/ /accton, acctwtmp: 
file. chown: change 
chown, chgrp: change 
compress and expand/ 
and optimization 

mptx: the macro 
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object file. /section . . 
object file. 
object file symbol table/ 
object file symbol table 
object files. filehdr: . . 
object files in binary/ . 
object files. Id: 
object files. /print .. 
object library. /find . . 
octal dump. 
ocurse: optimized screen 
od: octal dump. 
open a common object . 
open a file specified by . 
open a stream. 
open file descriptor. .. 
open for reading or . . 
open: open for reading . 
openi: open a file 
operating system 
operating system/ ... 
operations. /memcmp, . 
operations. 
operations. 
operations. 
operations. 
operations. 
operations. 
operations. /strspn, 
operations. /tputs: 
operator. join: 
optimal access time. . . 
optimization package. . 
optimized screen . «2 « 
option letter from ... 
optional file header of . 
options. 
options for a terminal. . 
options. 
options. Ipset: set 
options on sockets. .. 
ordering relation for an 
ordinary file. 
osdd, checkmm: .... 
out-going terminal line/ 
output. /assembler . . 
output device. /long . 
output logfile 
output of a varargs/ . . 
output. /fprintf, ... 
output. /startand .. 
overview of accounting . 
owner and group ofa. 
owner or group. 
pack, peat, unpack: .. 
package. /handling 
package for formatting a/ 


semcetl: 


shmetl: 


° 
. 

. 

. 
eee ew 
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. 
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senhdr(4) 
strip(1) 
Idgetname(3X) 
syms(4) 
filehdr(4) 
cpset(1M) 
ld(1) 

size(1) 
lorder(1) 
od(1) 
ocurse(3X) 
od(1) 
Idopen(3X) 
openi(2) 
fopen(3S) 
dup(2) 
open(2) 
open(2) 
openi(2) 
prf(7) 
profiler(1M) 
memory(3C) 
msgctl(2) 
msgop(2) 
semctl(2) 
semop(2) 
shmctl(2) 
shmop(2) 
string(3C) 
termcap(3X) 
join(1) 
dceopy(1M) 
eurses(3X) 
ocurse(3X) 
getopt(3C) | 
ldohseek(3X) 
fentl(5) 
stty(1) 

getopt(1) 

Ipset(1M) 

getsockopt(2N) 

lorder(1) 

mknod(2) 

mm(1) 

dial(3C) 

a.out(4) 

fold(1) 

uulog(1C) 

yprintf(3S) 

print{(3S) 

rsterm(1M) 

acct(1M) 

chown(2} 

chown(1) 

pack(1) 

eurses(3X)} 

mptx(5) 


mm: the MM macro 
view/ mv: a troff macro 
system activity report 
buffered input/output 
communication 

more, 

TEKTRONIX 4014/ 4014: 
options. lpset: set 
interface. Ip: 

772/ xmset: set drive 
network interface 
/process group, and 
getopt: 

password. 


/endpwent, fgetpwent: get 
putpwent: write 
passwd: 

getpass: read a 

passwd: change login 
checkers. pwcek, grpck: 
of several files or/ 

file for command. 
deliver portions of 
working/ getcwd: get 
search a file for a 
processing/ awk: 

until signal. 

and expand files. pack, 
to/from a/ popen, 
provide truth/ mc68k, 
get name of connected 
the UUCP directories and 
mesg: 

package for formatting a 
ptx: 

file format. acct: 
/command summary from 
sys_errlist, sys_nerr:/ 
soft-copy/ pg: file 
more, page: text 

for soft-copy / 

split: split a file into 
interprocess channel. 
tee: 

popen, pclose: initiate 
fish: 

text, or data in/ 
interface. 

subroutines. 

/ftell: reposition a file 
move read/write file 
pipe to/from a process. 
library maintainer for 
/dirname: deliver 
banner: make 

exp, log, log10, 
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package for formatting/ 
package for typesetting 
package. /sa2,sadc: . 
package. /standard . 
package. /interprocess 
page: text perusal. . . . 
paginator forthe ... 
parallel line printer . . 
parallel printer... . 
parameters for Xylogics 

parameters. /configure 

parent process IDs. . . 
parse command options. 
passwd: change login. 
passwd: password file. . 
password file entry. . . 
password file entry. . . 
password file. . . 2... 
password. 
password. 
password/group file . 
paste: merge same lines 
path: locate executable 
path names. /dirname: 
path-name of current 

pattern. /egrep, fgrep: 
pattern scanning and 

pause: suspend process 
peat, unpack: compress 
pelose: initiate pipe .. 
pdp1ll, u3b, u3b5, vax: . 
peer. getpeername: . . 
Permissions file. /check 
permit or deny messages. 
permuted index. /macro 
permuted index. . .. « 
per-process accounting . 
per-process accounting/ 

perror, errno, « « + + 
perusal filter for .... 
perusal. 
pg: file perusal filter . . 
pieces. 2. 2. ee we eo 
pipe: create an . .. 
pipe fitting. . . 2... 
pipe to/from a process. 

play “Go Fish”. ... - 
plock: lock process, . . 
plot: graphics ..... 
plot: graphics interface . 
pointer inastream. . . 
pointer. Iseek: ... » 
popen, pclose: initiate . 
portable archives. /and 

portions of path names. 

posters, 
pow, sqrt: exponential, / 


- 34- 


mm(5) 
mv(5) 
sar(1M) 
stdio(3S) 
stdipe(3C) 
more(1) 
4014(1) 
Ipset(1M) 
Ip(7) 
xmset(1M) 
ifeonfig(1NM) 
getpid(2) 
getopt(1) 
passwd(1) 
passwd(4) 
getpwent(3C) 
putpwent(3C) 
passw d(4) 
getpass(3C) 
passwd(1) 
pwek(1M) 
paste(1) 
path(1) 
basename(1) 
getcwd(3C) 
grep(1) 
awk(1) 
pause(2) 
pack(1) 
popen(3S) 
machid(1) 
getpeername(2N) 
uucheck(1M) 
mesg(1) 
mptx(5) 
ptx(1) 
acet(4) 
acctcms(1M) 
perror(3C) 
pg(1) 
more(1) 
pg(1) 
split(1) 
pipe(2) 
tee(1) 
popen(3S) 
fish(6) 
plock(2) 
plot(4) 
plot(3X) 
fseek(3S) 
Iseek(2) 
popen(3S) 
ar(1) 
basename(1) 
banner(1) 
exp(3M) 


/exponential, logarithm, 
bre, bcheckre, re, 


/monacct, nulladm, 
/nulladm, pretmp, 

text for/ ew, checkew: 
profile. monitor: 

cpp: the C language 
/determine C language 
file. unget: undo a 
profiler. 

prfid, prfstat, 

prfsnap, prfpr:/ 
/prfstat, prfde, prfsnap, 
prfid, prfstat, prfde, 
prfpr: operating/ prfid, 
of/ gps: graphical 
types. types: 

window management 
hopefully/ fortune: 
prs: 

date: 

eal: 

count of a file. sum: 
editing activity. sact: 
manual. man, manprog: 
cat: concatenate and 


pr: 

of/ /vfprintf, veprintf: 
/fprintf, sprintf: 
information. Ipstat: 
common object file. nm: 
CTIX system. uname: 
news: 

from proto file;/ qlist: 
blocks/ bcheck: 
acctcom: search and 
trpt: 

common object / size: 
and names. id: 

mm, osdd, checkmm: 
Ip: parallel 

requests to an LP line 
a PT or GT local 
Ipset: set parallel line 
Ipr: line 
enable/disable LP 
sprintf: print/ 

run a command at low 
nice: change 

process/ renice: alter 
logged errors. errpt: 
acct: enable or disable 
acctprel, acctprc2: 
/search and print 
alarm: set a 

process/ times: get 
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power, square root/ .. 
powerfail, drvload:/ . . 
pr: print files. . 2... . 
pretmp, prdaily,/ ... 
prdaily, prtacct,/ . .. 
prepare constant-width 

prepare execution 
preprocessor. 
preprocessor include/ =. 
previous get of an SCCS 
prf: operating system . 
prfdc, prfsnap, prfpr:/  . 
prfid, prfstat, prfdc, 
prfpr: operating system/ 
prfsnap, prfpr:/ ... . 
prfstat, prfdc, prfsnap, . 
primitive string, format 

primitive system data . 
primitives. window: . . 
print arandom, .... 
print an SCCS file. .. 
print and set the date. . 
print calendar. 
print checksum and block 
print current SCCS file 

print entries in this . 

print files. 
print files. 
print formatted output 
print formatted output. 
print LP status 

print name list of 
print name of current . 
print news items. 
print out file lists 
print out the list of . . 
print process accounting/ 
print protocol trace. 
print section sizes of 
print user and group IDs 
print/check documents / 
printer interface. 
printer. /send/cancel . 
printer. /or relocate . . 
printer options. 
printer spooler. ... . 
printers. /disable: . . . 
printf, fprintf, 
priority. nice: . 2... 
priority of a process. . . 
priority of running .. 
process areportof... 
process accounting. . . 
process accounting. .. 
process accounting/ . . 
process alarm clock. .. 
process and child ... 


. 
eee eee 
. 
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exp(3M) 
bre(1M) 
pr(1) 
acctsh(1M) 
aectsh(1M) 
ew(1) 
monitor(3C) 
epp(1) 
includes(1) 
unget(1) 
prf(7) 
profiler(1M) 
profiler(1M) 
profiler(1M) 
profiler(1M) 
profiler(1M) 
gps(4) 
types(5) 
window(7) 
fortune(6) 
prs(1) 
date(1) 
cal(1) 
sum(1) 


- sact(1) 


man(1) 
cat(1) 
pr(1) 
vprintf(3S) 
printf(3S) 
Ipstat(1) 
nm(1) 
uname(1) 
news(1) 
qtist(1) 
beheck(1M) 
acctcom(1) 
trpt(1NM) 
size(1) 
id(1) 
mm(1) 
Ip(7) 

Ip(1) 
mktpy(1) 
Ipset(1M) 
Ipr(1) 
enable(1) 
printf(3S) 
nice(1) 
nice(2) 
renice(1) 
errpt(1M) 
acct(2) 
acctpre(1M) 
acctcom(1) 
alarm(2) 
times(2) 


/priority of running 
init, telinit: 

/time a command; report 
exit, _exit: terminate 
fork: create a new 
/getppid: get process, 
setpgrp: set 

group, and parent 
script for the init 

kill: terminate a 
change priority of a 
kill: send a signal to a 
initiate pipe to/from a 
/getpgrp, getppid: get 
ps: report 

in memory. plock: lock 
get process and child 
wait: wait for child 
ptrace: 

pause: suspend 

await completion of 
/list of file systems 

a process or a group of 
killall: kill all active 

or file/ fuser: identify 
/pattern scanning and 
halt: terminate all 
/interactive message 
m4: macro 

truth value about your 
data. 

function. 

profile. 

prof: display 

prepare execution 
profil: execution time 
environment at login/ 
function. prof: 

prf: operating system 
prfpr: operating system 
sadp: disk access 
/command 

/using the mkfs(1) 
/out file lists from 
/endprotoent: get 
Internet File Transfer 
telnetd: DARPA TELNET 
Trivial File Transfer 
user interface to TELNET 
to the DARPA TFTP 
trpt: print 
ACU/modem calling 
Internet protocols. 

list of Internet 

update: 

facts. arithmetic: 
/pdp11, u3b, u3b5, vax: 
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process by changing/ . . 
process control/ ..... 
process data and system/ 

process. 
process. 
process group, and/ ... 
process group ID. .... 
process IDs. /process . . 
process. inittab: .... 
process. 2... eee oe 
process. nice: 
process or a group of/ .. 
process. popen, pclose: . . 
process, process group,/ . 
process status. 
process, text, or data .. 
process times. times: .. 
process tostopor/ ... 
process trace. 
process until signal. .. . 
process. wait: . . +... 
processed by fsck. 
processes. /asignalto .. 
processes. 
processes using a file . .. 
processing language. . . . 
processing. shutdown, . . 
processing system. .... 
processor. 
processor type. /provide . 


prof: display profile .... 


prof: profile withina . . . 


profil: execution time .. 
profile data. . 2... 
profile. monitor; .... 


profile. . 2. 2 2 eee we 
profile: setting up an us 
profile withina ..... 
profiler. 
profiler. /prfsnap, . . . + 
profiler. 
programming language. . 
proto file database. ... 
proto file; set links/ ... 
protocol entry. 
Protocol server. /DARPA 
protocol server. 
Protocol server. /DARPA 
protocol. telnet: .... 
protocol. /interface ... 
protocol trace. .. « . 
protocols. Dialers: . . . . 
protocols: list of . .... 
protocols. protocols: . . . 
provide disk/ ..... 
provide drillin number. 
provide truth value/ ... 


eee ee ew 


oe © we 
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renice(1) 
init(1M) 
timex(1) 
exit(2) 
fork(2) 
getpid(2) 

set pgrp(2) 
getpid(2) 
inittab(4) 
kill(1) 
nice(2) 

kill(2) 
popen(3S) 
getpid(2) 
ps(1) 
plock(2) 
times(2) 
wait(2) 
ptrace(2) 
pause(2) 
wait(1) 
checklist(4) 
kill(2) 
killall(1M) 
fuser(1M) 
awk(1) 
shutdown(1M) 
mailx(1) 
m4(1) 
machid(1) 
prof(1) 
prof(5) 
profil(2) 
prof(1) 
monitor(3C) 
profil(2) 
profile(4) 
prof(5) 
pri(7) 
profiler(1M) 
sadp({1M) 
sh(1) 
qinstall(1) 
qlist(1) 
getprotoent(3N) 
ftpd(1NM) 
telnetd(1NM) 
tftpd(1NM) 
telnet(1N) 
tftp(1N) 
trpt(1NM) 
Dialers(5) 
protocols(4N) 
protocols(4N) 
update(1M) 
arithmetic(6) 
machid(1) 


true, false: 


/pretmp, prdaily, 
status. 

sxt: 

/uniformly distributed 
/install or relocate a 
download. tdl, gtdl, 


input stream. ungetc: 
putw: put character or/ 
put character or/ pute, 
value to environment. 
file entry. 

string on a stream. 
/getutid, getutline, 
putc, putchar, fpute, 
password/group file/ 
name. 

tape. 

qic: interface for 

verify software using/ 
lists from proto file;/ 


tput: 

msgget: get message 
iperm: remove a message 
qsort: 

immune to hangups and 
knowledge. 
random-number/ 
fortune: print a 

rand, srand: simple 
fsplit: split FORTRAN, 
system/ bre, bcheckre, 
command execution. 
ruserok: routines for/ 


getpass: 

table entry/ Idtbread: 
Idshread, Idnshread: 
read: 

send mail to users or 
line: 


of a member/ Idahread: 
a common/ Idfhread: 

a common object file for 
open: open for 

Iseek: move 

memory/ malloc, free, 
mallopt,/ malloc, free, 
system. 

reboot: 

/specify what to do upon 
socket. recv, recvfrom: 
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provide truth values. ee alte 
prs: print an SCCS file. 
prtacct, runacet,/ ..... 
ps: report process ..... 
pseudo-device driver. Sse 
pseudo-random numbers. . . 
PT or GT local printer. .. 
ptdl: RS-232 terminal ... 
ptrace: process trace. ry 
ptx: permuted index. 
push character back into . . 
putc, putchar, fputc, ... 
putchar, fputc, putw: ... 
putenv: change oradd ... 
putpwent: write password. 
puts, fputs: puta . 2... 
pututline, setutent,/ .... 
putw: put character or/ .. 
pwek, erpck: 
pwd: working directory .. 
qic: interface for QIC  ... 
QIC tape. = 
qinstall: install and .... 
qlist: print out file . . 

qsort: quicker sort. .... 
query terminfo database, a 
queue. 2. eee eee ae 
queue, semaphore set or/ . 
quicker sort. . 
quits. /runacommand . 


quiz: test your 
rand, srand: simple .. 

random, hopefully/  . . 

random-number generator. 
ratfor, or eflfiles. . 2... 
re, powerfail, drvload: . . 
remd: remote shell . . 1... 
remd, rresvyport, . . +... 
rep: remote file copy. ... 
read a password. ..... 
read an indexed symbol .. 
read an indexed/named / 
read fromfilee ....2-. 
read mail. mail, rmail: . . . 
read one line. . 2. 2 2 oe 
read: read from file. .... 
read the archive header 
read the file header of 
reading. /Idaopen: open .. 
reading or writing. 6: was de 
read/write file pointer. .. . 
Tealloc, calloc: main .... 
realloc, calloc, . . 2... s.- 
reboot: reboot the ..... 
reboot the system. ..... 
receipt of asignal. ..... 
receive a message froma .. 
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true(1) 


- prs(1) 


acctsh(1M) 
ps(1) 


- sxt(7) 


drand48(3C) 
mktpy(1) 
tdl(1) 
ptrace(2) 


- ptx(1) 


ungetc¢(3S) 


» putc(3S) 


pute(3S) 
putenv(3C) 
putpwent(3C) 
puts(3S) 
getut(3C) 
putc(3S) 


« pwek(1M) 


pwd(1) 
qic(7) 


- qic(7) 


qinstall(1) 
qlist(1) 
qsort(3C) 
tput(1) 


- msgget(2) 


iperm(1) 
qsort(3C) 
nohup(1) 
quiz(6) 
rand(3C) 
fortune(6) 
rand(3C} 
fsplit(1) 
bre(1M) 
remd(1N) 
remd(3N) 
rep(1N) 
getpass(3C) 
Idtbread(3X) 


. Idshread(3X) 


read(2) 
mail(1) 
line(1) 
read(2) 


- Idahread(3X) 
- Idfhread(3X) 


Idopen(3X) 
open(2) 
Iseek(2) 
malloc(3C) 
malloc(3X) 
reboot(1M) 
reboot(1M) 
signal(2) 
recy(2N) 


lockf: 

per-process accounting 
errdead: extract error 
connect accounting 
backup tape. frec: 

a message from a/ 
message from a/ recv, 
ed, 

and execute regular/ 
expression compile. 
/maintain, update, and 
execute regular/ regemp, 
expression compile and/ 
/exclusive access to 
compile and/ regexp: 
compile. regemp: 
/compile and execute 
requests. accept, 

two/ comm: select or 
lorder: find ordering 
operator. join: 
information for a/ 
mktpy, mvtpy: install or 
/idnrseek: seek to 

for a common/ reloc: 
/fabs: floor, ceiling, 
calendar: 

uux: CTIX to CTIX 
returning a stream to a 
uuxqt: execute 

return stream toa 
rhosts: 

rexecd: 

rep: 

rlogin: 

rlogind: 

execution. remd: 

rshd: 

Uutry: try to contact a 
ct: spawn getty toa 
SCCS file. rmdel: 
semaphore set or/ iperm: 
unlink: 

disk. dismount: 
directories. rm, rmdir: 
and eqn/ deroff: 

of running process by/ 
check and interactive 
file. unig: report 
clock: 

fsize: 

communication/ ipes: 
disk blocks. df: 

errpt: process a 

sade: system activity 
timex: time a command; 
ps: 
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record locking on files. . 
records. /summary from 
records and status/ . . 
records. /manipulate . 
recover files froma .. 
recy, recvfrom: receive . 
recvfrom: receivea . 
red: text editor. 
regemp, regex: compile . 
regemp: regular 
regenerate groups of/ . 
regex: compile and... 
regexp: regular... © 
regions of afile. .... 
regular expression .. . 
regular expression .. . 
regular expression. . . « 
reject: allow/prevent LP 
reject lines common to . 
relation for an object/ . 
relational database . . 
reloc: relocation . ... 
relocatea PT or GT/ . 
relocation entries of a/ . 
relocation information . 
remainder, absolute/ . . 


ee ee 


reminder service. .. . 
remote command/ .. . 
remote command. /for . 


remote command requests. 
remote command. rexec: 

remote equivalent users. 

remote execution server. 

remote file copy. 
remote login. 
remote login server. 
remote shell command . 
remote shell server. 
remote system with/ . . 
remote terminal. 
remove a delta from an 

remove a message queue, 
remove directory entry. 

remove exchangeable . . 
remove files or 
remove nroff/troff, tbl, . 
renice: alter priority 
repair. /consistency . . 
repeated lines ina .. . 
report CPU time used. . 
report file size. 
report inter-process 
report number of free. 
report of logged errors. . 
report package. /sa2, . 
report process data and/ 
report process status. . 


eee 
se e © 
ee 


ee ee 
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lockf(3C) 
acctems(1M) 
errdead(1M) 
fwtmp(1M) 
frec(1M) 
recv(2N) 
recv(2N) 
ed(1) 
regemp(3X) 
regemp(1) 
make(1) 
regemp(3X) 
regexp(5) 
locking(2) 
regexp(5) 
regcmp(1) 
regcmp(3X) 
accept(1M) 
comm(1) 
lorder(1) 
join(1)} 
reloc(4) 
mktpy(1) 
Idrseek(3X) 
reloc(4) 
Noor(3M) 
calendar(1) 
uux(1C) 
remd(3N) 
uuxqt(1M) 
rexec(3N) 
rhosts(4N) 
rexecd(1NM) 
rep(1N) 
rlogin(1N) 
rlogind(1NM) 
remd(1N) 
rshd(1NM) 
Uutry(1M) 
et(1C) 
rmdel(1) 
iperm(1) 
unlink(2) 
dismount(1) 
rm(1) 
deroff(1) 
renice(1) 
fsck(1M) 
uniq(1) 
clock(3C) 
fsize(1) 
ipes(1) 
df(1M) 
errpt(1M) 
sar(1M) 
timex(1) 
ps(1) 


a file. unig: 
sar: system activity 
fseek, rewind, ftell: 

move/ /start/stop the LP 
reject: allow/prevent LP 
scheduler and move 
syslocal: special system 
Ip, cancel: send/cancel 
execute remote command 
common/ Idgetname: 
value. abs: 

user. logname: 

remote command. rexec: 
environment/ getenv: 
call. stat: data 

/ruserok: routines for 
col: filter 

reposition a/ fseek, 
/create a new file or 

a remote command. 
server. 

equivalent users. 


server. 
or directories. 

users or read/ mail, 
from an SCCS file. 
directories. rm, 

chroot: change 
command. chroot: change 
/logarithm, power, square 
manipulate the routing/ 
/td: graphical device 
/tresvport, ruserok: 
address manipulation 
object file access 

compile and match 

table of contents 
manually manipulate the 
routines for/ remd, 
/termina)’s loca} 

tdl, gtdl, ptdl: 
standard/restricted/ sh, 
server. 

and stop terminal input / 
priority. nice: 

hangups and/ nohup: 
runacct: 

accounting. 

/prdaily, prtacct, 

/alter priority of 

of nodes on local/ 

remd, rresvport, 

on local network. 

server. 

activity report/ 

activity report/ sal, 
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report repeated lines in =. 
reporter. 
reposition a file/ 
request scheduler and .. 
requests. accept, 
requests. /LP request .. 
requests. 
requests to an LP line/ . . 
requests. uuxqt: 
retrieve symbol name for . 
return integer absolute . . 
return login nameof ... 
return streamtoa .... 
return value for 
returned by stat system . 
returning astreamtoa/ . 
reverse line-feeds. 
rewind, ftell: 
rewrite an existingone. . 
rexec: return stream to .. 
rexecd: remote execution . 
rhosts: remote 
tlogin: remote login. 
rlogind: remote login . . . 
rm, rmdir: remove files . . 
rmail: send mailto . 
rmdel: remove a delta 

rmdir: remove files or 

root directory. 
root directory for a 
root functions. 

route: manually 
routines and filters. 
routines for returning a/ . 
routines. /Internet 
routines, Idfen: common . 
routines. /expression . . 
routines. /graphical . . . 
routing tables. route: .. 
rresvport, ruserok: . . . « 
RS-232 channels. .... 
RS-232 terminal/ .... 
rsh: shell, the 
rshd: remote shell . ... 
rsterm: manually start .. 
run a command atlow .. 
run a command immune to 
run daily accounting. .. 
runacct: run daily 
runacct, shutacct,/ ... 
running process by/ .. . 
ruptime: display status . . 
ruserok: routines for/ . . 
rwho: who is loggedin .. 
rwhod: node status .. . 
sal, sa2, sade: system .. 
sa2, sade: system 


oe we ew we 
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ee ee we . 


uniq(1) 
sar(1) 
fseek(3S) 
Ipsched(1M) 
accept(1M) 
\psched(1M) 
syslocal(2) 
Ip(1) 
uuxgt(1M) 
Idgetname(3X) 
abs(3C) 
logname(3X) 
rexec(3N) 
getenv(3C) 
stat(5) 
remd(3N) 
col(1) 
fseek(3S) 
creat(2) 
rexec(3N) 
rexecd(1NM) 
rhosts(4N) 
rlogin(1N) 
rlogind(1NM) 
rm({1) 
cane) 
rmdel(1) 
rm(1) 
chroot(2) 
chroot(1M) 
exp(3M) 
route(1NM) 
gdev(1G) 
remd(3N) 
inet(3N) 
ldfen(4) 
regexp(5) 
toc(1G) 
route(1NM) 
remd(3N) 
tp(7) 

tdl(1) 

sh(1) 
rshd(1NM) 
rsterm(1M) 
nice(1) 
nohup(1) 
runacct(1M) 
runacct(1M) 
acctsh(1M) 
renice(1) 
ruptime(1N) 
remd(3N) 
rwho(1N) 
rwhod(1NM) 
sar(1M) 
sar(1M) 


file editing activity. 
report/ sal, sa2, 
profiler. 

graph. 

reporter. 

segment space/ brk, 
convert formatted/ 
bfs: big file 

language. awk: pattern 
delta commentary of an 
comb: combine 

a delta (change) to an 
sact: print current 

get: get a version of an 
prs: print an 

remove a delta from an 
two versions of an 
secsfile: format of 

a previous get of an 
val: validate 

create and administer 
what: identify 

versions of an SCCS/ 
file. 

/the LP request 
system. uusched: the 
for a common object/ 
clear: clear terminal 
ocurse: optimized 
curses: CRT 

display editor/ vi: 
process. inittab: 

of terminal session. 
initialization shell 


difference program. 
grep, egrep, fgrep: 
bsearch: binary 
accounting/ acctcom: 
Isearch, Ifind: linear 
hdestroy: manage hash 
twalk: manage binary 
common object/ scnhdr: 
/read an indexed/named 
line number entries of a 
relocation entries of a 
/to an indexed /named 
object/ size: print 


/jrand48, srand48, 
Idsseek, Idnsseek: 
Idlseek, Idnlseek: 
Idrseek, ldnrseek: 

file header/ Idohseek: 
of a common/ ldtbseek: 
get shared memory 

brk, sbrk: change data 
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sact: print current SCCS .. 
sadc: system activity .... 
sadp: disk access 
sag: system activity .. . 
sar: system activity ... 
sbrk: change data .... 
scanf, fscanf, sscanf: 
scanner. «2 ee ee eee 
scanning and processing . . 
SCCS delta. /change the . 
SCCS deltas. . 2... 2s 
SCCS file. delta: make .. 
SCCS file editing/ 
SCCS file. 
SCCS file. 
SCCS file. rmdel: 
SCCS file. /eompare ... 
SCCS file. 
SCCS file. 
SCCS file. 
SCCS files. admin: .... 
SCCS files. 
sceesdiff: compare two ... 
seesfile: format of SCCS .. 
scheduler and move/ .... 
scheduler for the UUCP 
senhdr: section header 
screen. 
screen functions. 
screen handling and/ 
screen-oriented (visual) 
script for the init 
script: make typescript 
scripts. /system 
sdb: symbolic debugger. 
sdiff: side-by-side 
search afilefora/ .... 
search asorted table. .. 
search and print process 
search and update. 
search tables. /hcreate, . . 
search trees. /tdelete, .. . 
section header fora .... 
section header ofa/ .... 
section of acommon/ /to . 
section of acommon/ /to . 
section of acommon/ .. . 
section sizes of common .. 
sed: stream editor. 
seed 48, lcong48:/ 
seek toan/ .. 
seek to line number/ . ... 
seek to relocation/ ..... 
seek to the optional .... 
seek to the symbol table . . 
segment. shmeget: 
segment space/ 
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sact(1) 
sar(1M) 
sadp(1M) 
sag(1G) 
sar(1) 
brk(2) 
scanf(3S) 
bfs(1) 
awk(1) 
cde(1) 
comb(1) 
delta(1) 
sact(1) 
get(1) 

prs(1) 
rmdel(1) 
scesdiff(1) 
scesfile(4) 
unget(1) 
val(1) 
admin(1) 
what(1) 
scesdiff(1) 
sccsfile(4) 
Ipsched(1M) 
uusched(1M) 
senhdr(4) 
clear(1) 
ocurse(3X) 
curses(3X) 
vi(1) 
inittab(4) 
script(1) 
bre(1M) 
sdb(1) 
sdiff(1 
grep(1 
bsearch(3C) 
acctcom(1) 
lsearch(3C) 
hsearch(3C) 
tsearch(3C) 
senhdr(4) 
Idshread(3X) 
Idlseek(3X) 
idrseek(3X) 
Idsseek(3X) 
size(1) 
sed(1) 
drand48(3C) 
Idsseek(3X) 
Idiseek (3X) 
ldrseek(3X) 
Idohseek(3X) 
Idtbseek(3X) 


common to two/ comm: 
greek: 

line of a/ cut: cut out 
object file. dump: dump 
operations. semctl: 
semop: 

/remove a message queue, 
semget: get set of 
control operations. 
semaphores. 

operations. 

socket. send, sendto: 
process or a/ kill: 

read mail. mail, rmail: 
Message to a socket. 

an LP line/ Ip, cancel: 
to a socket. send, 
/attach and detach 

File Transfer Protocol 
rexecd: remote execution 
rlogind: remote login 
rshd: remote shell 
rwhod: node status 
DARPA TELNET protocol 
File Transfer Protocol 
uucpd: network uucp 
typescript of terminal 
Internet address from/ 
buffering to a stream. 
address on disk. 

group Ds. setuid, 
/getgrgid, getgrnam, 
get/ /gethostbyname, 
non-local goto. 

generate hashing/ crypt, 
table. 

get/ /getnetbyname, 
group ID. 
/getprotobyname, 
/getpwuid, getpwnam, 
get/ /getservbyname, 
options on/ getsockopt, 
environment/ cprofile: 
environment at/ profile: 
/speed and terminal 

and group IDs. 

system. 

/getutline, pututline, 
buffering to a/ setbuf, 
integer data in/ sputl, 
standard/restricted/ 
xstr: extract and 
operations. shmctl: 
/queue, semaphore set or 
operations. shmop: 
shmget: get 

remd: remote 
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select or reject lines . . 
select terminal filter. . . 
selected fields of each . 
selected partsofan .. 
semaphore control 
semaphore operations. . 
semaphore set or shared / 
semaphores. 
semctl: semaphore .. . 
semget: get set of 
semop: semaphore 
send a message to a 
send a signal to a 
send mail to usersor . . 
send, sendto: send a 
send/cancel requests to 
sendto: send a message . 
serial lines as network/ 
server. /DARPA Internet 
server. . 2 ee ee ee 
SCrver. 2 see ee we 
server, 2 2 2 ee eee 
server. . 2 ee ee ee 
server. 
server. /DARPA Trivial 
server. 
session. script: make . 
setaddr: set DARPA .. 
setbuf, setvbuf: assign . 
setenet: write Ethernet . 
setgid: set user and .. 
setgrent, endgrent,/ . . 
sethostent, endhostent: . 
setjmp, longjmp: 
setkey, encrypt: 
setmnt: establish mount 
setnetent, endnetent: . 
setpgrp: set process .. 
setprotoent,/ 
setpwent, endpwent,/ . 
setservent, endservent: . 
setsockopt: get and set . 
setting up aC shell .. 
setting up an 
settings used by getty. . 
setuid, setgid: set user . 
setuname: set nameof . 
setutent, endutent,/ . . 
setvbuf: assign 
sgetl: access long ... 
sh, rsh: shell, the ... 
share stringsinC/ .. 
shared memory control . 
shared memory id. . . . 
shared memory 
shared memory segment. 
shell command execution. 


ee ee 2 
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telnetd: . 2. 22. 


ee © © woe 


comm(1) 
greek(1) 
ceut(1) 
dump(1) 
semctl(2) 
semop(2) 
iperm(1) 
semget(2) 
semctl(2) 
semget(2) 
semop(2) 
send(2N) 
kill(2) 

mail(1) 
send(2N) 
Ip(1) 
send(2N) 
slattach(1NM) 
ftpd(INM) 
rexecd(1NM) 
rlogind(1NM) 
rshd(1NM) 
rwhod(1NM) 
telnetd(1NM) 
tftpd(1NM) 
uucpd(INM) 
script(1) 
setaddr(1NM) 
setbuf(3S) 
setenet(INM) 
setuid(2) 


- getgrent(3C) 


gethostent(3N) 
setjmp(3C) 

ery pt(3C) 
setmnt(1M) 
getnetent(3N) 
setpgrp(2) 
getprotoent(3N) 
getpwent(3C) 
getservent(3N) 
getsockopt(2N) 
eprofile(4) 
profile(4) 

getty defs(4) 
setuid(2) 
setuname(1M) 
getut(3C) 
setbuf(3S) 
sputl(3X) 

sh(1) 

xstr(1) 
shmctl(2) 
iperm(1)} 
shmop(2) 
shmget(2) 
remd(1N) 


interpreter)/ csh: a 
system: issue a 

cprofile: setting up a C 
shi: 

/startup, turnacct: 
system initialization 
rshd: remote 

sh, rsh: 

manager. 

control operations. 
memory segment. 
operations. 
full-duplex/ shutdown: 
/prtacct, runacct, 
terminate all/ 

of a full-duplex/ 
program. sdiff: 

login: 

suspend process until 
to do upon receipt of a 
do upon receipt of a/ 
group of/ kill: send a 
gsignal: software 
/generate programs for 
generator. rand, srand: 
acos, atan, atan2:/ 
hyperbolic functions. 
fsize: report file 

sizes of common object / 
size: print section 
attach and detach/ 
detach serial/ slattach, 
for an interval. 

for interval. 

view graphs, and 

view graphs and 

the/ ttyslot: find the 
spline: interpolate 
accept a connection on a 
bind: bind a name toa 
a connection on a 
endpoint for/ 

for connections on a 
getsockname: get 
receive a message from a 
send a message to a 
get and set options on 
/file perusal filter for 
ctinstall: install 

ssignal, gsignal: 

/install and verify 

sort: 

qsort: quicker 

files. 

tsort: topological 

lines common to two 
bsearch: binary search a 
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shell (command .... . 
shell command. 
shell environment at/ .. 
shell layer manager. .. . 
shell procedures for/ . . « 
shell scripts. /drvload: . . 
shell server. 
shell, the/ 

shl: shell layer 
shmctl: shared memory. 


ee ees 


oe we we ew ee 


shmget: get shared ... 


shmop: shared memory . - 


shut down partofa ... 
shutacct, startup,/ .. . 
shutdown, halt: .... 


shutdown: shut down part 
side-by-side difference . . 
sign on. 
Signal. pause: . . 2. « « 
signal. /specify what .. 
signal: specify what to .. 
signal to a process ora . - 
signals. ssignal, 
simple lexical tasks. . . . 
simple random-number . - 
sin, cos, tan, asin, .... 
sinh, cosh, tanh: .... 
size. 
size: print section .... 
sizes of common object/ . 
slattach, sldetach: .... 
sldetach: attach and 
sleep: suspend execution . 
sleep: suspend execution . 
slides. /documents, .. . 
slides. /for typesetting . . 
slot in the utmp file of .. 
smooth curve. . - - 6 « © 
socket. accept: . 2... 
socket. 
socket. /imitiate .... 
socket: create an. + « « 
socket. listen: listen . . . 
socket name. 
socket. recy, recvfrom: . . 
socket. send, sendto: .. 
sockets. /setsockopt: . - 
soft-copy terminals. .. . 
software. 2. see eee 
software signals. .... 
software using the/ .. . 
sort and/or merge files. 
sort. 6 2 © ee we we we we 
sort: sort and/or merge. 
Sort. 6 2 «© © ws ee ew we 
sorted files. /or reject . . 
sorted table. 
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csh(1) 
system(3S) 
cprofile(4) 
shl(1) 
acctsh(1M) 
bre(1M) 
rshd(1NM) 
sh(1) 

shi(1) 
shmctl(2) 
shmget(2) 
shmop(2) 
shutdown(2N) 
acctsh(1M 
sadeGa 
shutdown(2N) 
sdiff(1) 
login(1) 
pause(2) 
signal(2) 
signal(2) 
kill(2) 
ssignal(3C) 
lex(1) 
rand(3C) 
trig(3M) 
sinh(3M) 
fsize(1) 

size(1) 

size(1) 
slattach(1NM) 
slattach(1NM) 
sleep(1) 
sleep(3C} 
mmt(1) 

my(5) 
ttyslot(3C) 
spline(1G) 
accept(2N) 
bind(2N) 
connect(2N) 
socket(2N) 
listen(2N) 
getsock name(2N) 
recy(2N) 
send(2N) 
getsockopt(2N) 
pg(1) 
ctinstall(1) 
ssignal(3C) 
qinstall(1) 
sort(1) 
qsort(3C) 
sort(1) 
tsort(1) 
comm(1) 
bsearch(3C) 


change data segment 
/unexpand: expand tabs to 
terminal. ct: 

files. fspec: format 
openi: open a file 
receipt of a/ signal: 
terminal type, modes, 
terminal type, modes, 
settings/ gettydefs: 
spellin, hashcheck:/ 
spell, hashmake, 
/spellin, hashcheck: find 
smooth curve. 

pieces. split: 

esplit: context 

or ef] files. fsplit: 
pieces. 

uucleanup: uucp 

Ipr: line printer 
/configure the LP 
printf, fprintf, 

long integer data in a/ 
exp, log, log10, pow, 
/logarithm, power, 
random-number/ rand, 
/mrand48, jrand48, 
scanf, fscanf, 

software signals. 

input /output/ stdio: 
communication/ ftok: 
sh, rsh: shell, the 
input/ rsterm: manually 
Ipsched, Ipshut, Ipmove: 
/runacct, shutacct, 

stat system call. 

status. 

network useful with/ 
stat: data returned by 
useful with/ stat: 

/list file names and 
ustat: get file system 
dump. /error records and 
ipstat: print LP 
clearerr, fileno: stream 
control. uustat: uucp 
communication facilities 
netstat: show network 
ruptime: display 

ps: report process 
rwhod: node 

stat, fstat: get file 
input/output package. 


for child process to 
/manually start and 
strnemp, strepy,/ 
/strepy, strnepy, strlen, 
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space allocation. /sbrk: 
spaces, and vice versa. . 
spawn getty to a remote 
specification in text 
specified by i-node. 
specify what to do upon 
speed, and line/ /set . 
speed, and line/ /set . 
speed and terminal . . 
spell, hashmake, . ... 
spellin, hashcheck: find/ 
spelling errors. 
spline: interpolate 
split a file into 
Splits os: 6) Weve es 
split FORTRAN, ratfor, 
split: split a file into 
spool directory/ .... 
spooler. 
spooling system. . ... 
sprintf: print formatted / 
sputl, sgetl: access . . . 
sqrt: exponential,/ . .. 
square root functions. . 
srand: simple 
srand48, seed48,/ _. 
sscanf: convert/ . . 
ssignal, gsignal: .. .. 
standard buffered . 
standard interprocess . 
standard/restricted/ . . 
start and stop terminal 
start/stop the LP/ . . 
startup, turnacct: shell/ 
stat: data returned by . 
stat, fstat: get file ... 
stat: statistical . 2... 
stat system call. . 2... 
statistical network .. . 
statistics for afile/ . . 
statistics. 
status information from 
status information. .. 
status inquiries. /feof, . 
status inquiry and job . 
status. /inter-process . 
status. 
status of nodes on local/ 
status. 
status server. 
status. 
stdio: standard buffered 
stime: set time. 
stop or terminate. /wait 
stop terminal input and/ 
streat, strncat, stremp, . 
strehr, strrchr,/ . 2. - 
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brk(2) 
expand(1) 
et(1C) 
fspec(4) 
openi(2) 
signal(2) 
getty(1M) 
uugetty(1M) 
getty defs(4) 
spell(1) 
spell(1) 
spell(1) 
spline(1G) 
split(1) 
esplit(1) 
fsplit(1) 
split(1) 
uucleanup(1M) 
Ipr(1) 
Ipadmin(1M) 
printf(3S) 
sputl(3X) 
exp(3M) 
exp(3M) 
rand(3C) 
drand48(3C) 
seanf(3S) 
ssignal(3C) 


. stdio(3S) 


stdipe(3C) 
sh(1) 
rsterm(1M) 
Ipsched(1M) 


- acctsh(1M) 


stat(5) 
stat(2) 
stat(1G) 
stat(5) 
stat(1G) 
ff(1M) 
ustat(2) 
errdead(1M) 
Ipstat(1) 
ferror(3S) 
uustat(1C) 
ipes(1) 
netstat(1N) 
ruptime(1N) 
ps(1) 
rwhod(1NM) 
stat(2) 
stdio(3S) 
stime(2) 
wait(2) 
rsterm(1M) 
string(3C) 
string(3C) 


strcat, strncat, 

/stremp, strnemp, 
/strpbrk, strspn, 

sed: 

fflush: close or flush a 
freopen, fdopen: open a 
a file pointer in a 
character or word from a 
get a string froma 
character or word on a 
fputs: put a string on a 
assign buffering to a 
/feof, clearerr, fileno: 
/routines for returning a 
command. rexec: return 
back into input 

and base-64 ASCII 
convert date and time to 
floating-point number to 
gps: graphical primitive 
gets, fgets: get a 

puts, fputs: put a 
/strspn, strespn, strtok: 
strtod, atof: convert 
atof: convert ASCII 
/atol, atoi: convert 
ASCII text strings in a/ 
/extract the ASCII text 
xstr: extract and share 
line number information/ 
number/ strip: 

/strepy, strnepy, 
strncmp,/ streat, 
strcat, strncat, strcmp, 
/stremp, strnemp, strepy, 
/strlen, strehr, strrehr, 
/strnepy, strlen, strchr, 
/strrchr, strpbrk, 

string to/ 

strspn, strcespn, 

convert string to/ 

using a file or file 

for a terminal. 

another user. 

intro: introduction to 
plot: graphics interface 
/of several files or 

block count of a file. 
du: 

acctems: command 
sync: update the 

sync: update 

user. su: become 
interval. sleep: 

interval. sleep: 

signal. pause: 
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strcmp, strnemp, strepy,/ 

strepy, strncpy, strien,/ . 
strespn, strtok: string/ . . 
stream editor. 


stream. fclose, ..... 
stream. fopen, ...-.. 
stream. /reposition .. . 
stream. /getw: get ... 
stream. gets, fgets: ... 
stream. /putw: put ... 
Stream. puts, . 2. + ese 


stream. /setvbuf: .... 
stream status inquiries. . 
stream to a remote/ ... 
stream toaremote ... 
stream. /push character . 
string. /long integer . . . 
string. /asctime, tzset: . . 
string. /gevt: convert .. 
string, format off .... 
string from astream. .. 
string on astream. ... 
string operations. .... 
string to/ 
string to floating-point/ . 
string to integer. . 2. 
strings: extract the ... 
strings in a file. 
strings in C programs. . . 
strip: strip symbol and . . 
strip symbol and line .. 
strlen, strehr, strrcehr,/ . . 
strneat, stremp, 
strnemp, strepy,/ ...- 
strncpy, strlen, strchr,/ . 
strpbrk, strspn,/ . . +. 
strrehr, strpbrk,/ .. + « 
strspn, strespn, strtok:/ . 
strtod, atof: convert .. « 
strtok: string/ /strpbrk, . 
strtol, atol, atoi: 
structure. /processes . . 
stty: set the options .. . 
su: become super-user or . 
subroutines and/ .... 
subroutines. 
subsequent lines of one/ . 
sum: print checksum and . 
summarize disk usage. . . 
summary from per-process/ 
super block. 
super-block. 
super-user or another .. 
suspend execution for an . 
suspend execution for . . 
suspend process until .. 
swab: swap bytes. . .. « 


ze 6e 2 eo we ew 


ee ee 


ee ee oo 
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sed(1) 
fclose(3S) 
fopen(3S) 
fseek(3S) 
getc(3S) 
gets(3S) 
putc(3S) 
puts(3S) 
setbuf(3S) 
ferror(3S) 
remd(3N) 
rexec(3N) 
ungetc¢(3S) 
a641(3C) 
etime(3C) 
ecvt(3C) 
gps(4) 
gets(3S) 
puts(3S) 
string(3C) 
strtod(3C) 
atof(3C) 
strtol(3C) 
strings(1) 
strings(1) 
xstr(1) 
strip(1) 
strip(1) 
string(3C) 
string(3C) 
string(3C) 
seo) 
string(3C 
SeneaG) 
string(3C) 
strtod(3C) 
string(3C) 
strtol(3C) 
fuser(1M) 
stty(1) 

su(1) 
intro(3) 
plot(3X) 
paste(1) 
sum(1) 
du(1) 
acctcms(1M) 
syne(1) 
syne(2) 

su(1) 
sleep(1) 
sleep(3C) 
pause(2) 
swab(3C) 


interface. swap: 

swab: 

administrative/ 

write on a file. 

driver. 

strip: strip 

ldgetname: retrieve 

/for common object file 
/compute the index of a 
common/ /read an indexed 
syms: common object file 
Idtbseek: seek to the 
sdb: 

symbol table format. 
super-block, 

block. 

update: provide disk 
file. swrite: 

interpreter) with C-like 
system/ perror, errno, 
requests. 

/errno, sys_errlist, 
binary search a sorted 
object file symbol 

/the index of a symbol 
/read an indexed symbol 
object file symbol 
device information 
mounted file system 
/seek to the symbol 
toc: graphical 

setmnt: establish mount 
troff. tbl: format 
manage hash search 
manipulate the routing 
tabs: set 

terminal. 

expand, unexpand: expand 
ctags: create a 

part of a file. 

atan2:/ sin, cos, 
functions. sinh, cosh, 
Xylogics 772 half-inch 
tar: 

files from a backup 

qic: interface for QIC 


for simple lexical 
/remove nroff/troff, 
nroff or troff. 

/erase, hardcopy, tekset, 
binary/ tsearch, tfind, 
terminal download. 


hpd, erase, hardcopy, 


4014: paginator for the 
initialization. init, 
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swap administrative . . . 
swap bytes. .. 
swap: swap 
swrite: synchronous 
sxt: pseudo-device 

symbol and line number/ . . 
symbol name for common/ 
symbol table entry. .... 
symbol table entry of a/ .. 
symbol table entry ofa .. 
symbol table format. . ... 
symbol table of acommon/ . 
symbolic debugger. 
syms: common object file . . 
sync: update .. 
syne: update the super .. . 
synchronization. . . . 2... 
synchronous write on a 
syntax. /shell (command . . 
sys_errlist, sys_nerr: 
syslocal: special system .. . 
syS_nerr: system error/ ... 
table. bsearch: . 
table entry. /for common . 
table entry of a common/ 

table entry of acommon/ . 
table format. /eommon .. 
table. master: master . 
table. mnttab: ° 
table of a common object/ . 


o> © e we es ee 


7 ee eo 


table of contents/ 
table. 
tables for nroff or 
tables. /hdestroy: . . 
tables. route: manually 
tabs on aterminal .... 
tabs: set tabsona.. . 
tabs to spaces, and vice/ . . 
tags file. 
tail: deliver the last .... 
tan, asin, acos, atan, .... 
tanh: hyperbolic ..... - 
tape controller. /for .... 
tape file archiver. . .... 
tape. frec: recover... .. 
tape. . 2s we ew ewan 
tar: tape file archiver. ... 
tasks. /programs 
tbl, and eqn constructs. 
tbl: format tables for ... 
td: graphical device/ . .. 
tdelete, twalk: manage ... 
tdl, gtd], ptdl: RS-232 ... 
tee: pipe fitting, ..... 
tekset, td: graphical/ .. . 
TEKTRONIX 4014 terminal. 
telinit: process control .. . 


eee 
oe © © ee 
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- swap! 


(1M) 
swab(3C) 
phic 


» « Swrite(2) 


sxt(7) 
strip(1) 


- Idgetname(3X) 


Idgetname(3X) 
ldt bindex(3X) 
Idtbread(3X) 
syms(4) 
Idtbseek(3X) 
sdb(1) 

syms(4) 


- syne(2) 


syne(1) 
update(1M) 


- swrite(2) 


esh(1) 
perror(3C) 
syslocal(2) 
perror(3C) 
bsearch(3C) 
ldgetname(3X) 


. Idtbindex(3X) 


Idt bread(3X) 
syms(4) 
master(4) 
mnttab(4) 
ldtbseek(3X) 
toe(1G) 
setmnt(1M) 
tbl(1) 
hsearch(3C) 
route(1NM) 
tabs(1) 


. tabs(1) 


expand(1) 
ctags(1) 
tail(1) 
trig(3M) 
sinh(3M) 
xmset(1M) 
tar(1) 
frec(1M) 


- qic(7) 


tar(1) 
lex(1) 


- + deroff(1) 


tbi(1) 
gdev(iG) 
tsearch(3C) 
tdl(1) 
tee(1) 
gdev(1G) 
4014(1) 
init(IM) 


telnetd: DARPA 

/user interface to 

to TELNET protocol. 
protocol server. 

for a temporary/ tmpnam, 
tmpfile: create a 

/create a name for a 

for terminals. 

term: format of compiled 
term file.. 

capability data base. 

for the TEKTRONIX 4014 
of the DASI 450 
interface. tiop: 

base. termcap: 

base. terminfo: 

console: console 

spawn getty to a remote 
generate file name for 
tdl, gtdl, ptdl: RS-232 
/terminal inteface, and 
greek: select 

/tgetstr, tgoto, tputs: 
/manually start and stop 
tset: set terminal, 
termio: general 

tty: controlling 

establish an out-going 

of terminal types by 
clear: clear 

/make typescript of 

by/ gettydefs: speed and 
set the options for a 
tabs: set tabs on a 
inteface, and/ tset: set 
conlocate: locate a 

tty: get the name of the 
isatty: find name of a 
speed, and/ getty: set 
speed, and/ uugetty: set 
ttytype: list of 

vt: virtual 

of DASI 300 and 300s 
HP 2640 and 2621-series 
tp: controlling 

filter for soft-copy 
conventional names for 
kill: 

shutdown, halt: 

exit, _ exit: 
error-logging/ errstop: 
child process to stop or 
tie: 

tput: query 

capability data base. 
interface. 

evaluation command. 
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TELNET protocol server. 
TELNET protocol. .. 
telnet: user interface . . 

telnetd: DARPA TELNET 
tempnam: create a name 

temporary file. 
temporary file. 
term: conventional names 
term file. .. 2... 
term: format of compiled 
termcap: terminal 
terminal. /paginator . 
terminal. /functions . . 
terminal accelerator 
terminal capability data 
terminal capability data 
terminal. . 2. 2 ee 
terminal. ct: 
terminal. ctermid: 
terminal download. .. 
terminal environment. . 
terminal filter. 
terminal independent/ . 
terminal input and/ .. 
terminal inteface, and/ . 
terminal interface. 
terminal interface. . . . 
terminal line/ dial: . . 
terminal number. /list . 
terminal screen. . 
terminal session. .. . 


oe 8 


eee 


terminal settings used 
terminal. stty: 
terminal. 
terminal, terminal ... 
terminal to use as the/ . 
terminal. 


eee e we 


ee ee ew ee 


terminal. ttyname, .. . 


terminal type, modes, . 
terminal type, modes, . 
terminal types by/ .. 
terminal. 
terminals. /functions . 
terminals. /functions of 
terminal's local RS-232/ 
terminals. /file perusal 

terminals. term: .. - 
terminate a process. . . 
terminate all/ ..... 
terminate process. . . - 
terminate the 
terminate. /wait for . . 
terminfo compiler. . . . 
terminfo database. . . 
terminfo: terminal . . . 
termio: general terminal 
test: condition 
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telnetd(1NM) 
telnet(1N) 
telnet(1N) 
telnetd(1NM) 
tmpnam(3S) 
tmpfile(3S) 
tmpnam(3S) 
term(5) 
term(4) 
term(4) 
termcap(4) 
4014(1) 
450(1) 

tiop(7) 
termcap(4) 
terminfo(4) 
console(7) e 
et(1C) 
etermid(3S) 
tdl(1) 

tset(1) 
greek(1) 
termcap(3X) 
rsterm(1M) 


- tset(1) 


termio(7) 
tty(7) 
dial(3C) 
ttytype(4) 
clear(1) 
script(1) 
getty defs(4) 
stty(1) 
tabs(1) 
tset(1) 
conlocate(1M) | 
tty(1) 
ttyname(3C) 

getty(1M) 

uugetty(1M) 

ttytype(4) 

vt(7) 

300(1) 

hp(1) 

tp(7) 

pg(1) 

term(5) 

kill(1) 

shutdown(1M) 

exit(2) 

errstop(1M) 

wait(2) 

tic(1M) 

tput(1) 

terminfo(4) 

termio(7) 

test(1) 


quiz: 

ed, red: 

ex: 

ex for casual/ edit: 
change the format of a 
format specification in 
/format mathematical 
/prepare constant-width 
nroff: format 

plock: lock process, 
more, page: 

/extract the ASCH 
troff: typeset 

manage binary/ tsearch, 
interface to the DARPA 
the DARPA TFTP/ 
File Transfer Protocol / 
tgetflag, tgetstr,/ 
tgetent, tgetnum, 
tgetstr,/ tgetent, 
/tgetnum, tgetflag, 
/tgetflag, tgetstr, 


ttt, cubic: 

process data and/ timex: 
time: 

commands at a later 
environment at login 

for optimal access 


profil: execution 
an environment at login 
stime: set 


time: get 

/tzset: convert date and 
clock: report CPU 

TZ: 

child process times. 
access and modification 
and child process 

access and modification 
report process data and/ 
accelerator interface. 
temporary file. 

a name for a temporary/ 
/_toupper, _tolower, 
contents routines. 
/pclose: initiate pipe 
/tolower, _toupper, 
_tolower,/ toupper, 
tsort: 

acctmerg: merge or add 
modification times of a/ 
toupper, tolower, 
_toupper, _tolower,/ 
terminal’s local RS-232/ 
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test your knowledge. . . . 
text editor. 
text editor. 
text editor (variant of . . 
text file. newform: ... 
text files. fspec: . . . 
text for nroff or troff. .. 
text for troff. 
text. 
text, or data in memory. . 
text perusal. 
text strings ina file. 2... 
text. 
tfind, tdelete, twalk: . . . 
TFTP protocol. /user .. 
tftp: user interfaceto .. 
tftpd: DARPA Trivial . . 
tgetent, tgetnum, .... 
tgetflag, tgetstr,/ . 2... 
tgetnum, tgetflag, 
tgetstr, tgoto, tputs:/ .. 
tgoto, tputs: terminal/ . . 
tic: terminfo compiler. . . 
tic-tac-toe. 
time a command; report . 
time a command. 
time. /batch: execute 
time. /up a C shell 
time. /copy file systems 
time: get time. 
time profile. 
time. /setting up 
time. 
time: time a command. . . 
time. 
time to string. 
time used. 
time zone file. 
times: get process and . . 
times of a file. /update . 
times. /get process .. . 
times. utime: set file .. 
timex: time acommand; . 
tiop: terminal . ..... 
tmpfile: createa ....- 
tmpnam, tempnam: create 
toascii: translate/ 
toc: graphical table of .. 
to/from a process. . .. - 
_tolower, toascii:/ .... 
tolower, toupper, .... 
topological] sort. 
total accounting files. . . 
touch: update access and . 
_toupper, _tolower,/ . . . 
toupper, tolower, 
tp: controlling 


Cr 
eee e oe 


eer eee 


. 
. 
ee eee 
. 
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. 
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quiz(6) 

ed(1) 

ex(1) 

edit(1) 
newform(1) 
fspec(4) 
eqn(1) 

ew(1) 
nroff(1) 
plock(2) 
more(1) 
strings(1) 
troff(1) 
tsearch(3C) 
tftp(1N) 
tftp(1N) 
tftpd(1NM) 
termcap(3X) 
termcap(3X) 
termcap(3X} 
termcap(3X) 
termcap(3X) 
tic(1M) 
ttt(6) 
timex(1) 
time(1) 
at(1) 
cprofile(4) 
dcopy(1M) 
time(2) 
profil(2) 
profile(4) 
stime(2) 
time(1) 
time(2) 
etime(3C) 
clock(3C) 
tz(4) 
times(2) 
touch(1) 
times(2) 
utime(2) 
timex(1) 
tiop(7)} 
tmpfile(3S) 
tmpnam(3S) 
conv(3C) 
toc(1G) 
popen(3S) 
conv(3C) 
conv(3C) 
tsort(1) 
acctmerg(1M) 
touch(1) 
cony(3C) 
conv(3C) 
tp(7) 


database. 

/tgetstr, tgoto, 
characters. 

ptrace: process 

trpt: print protocol 

ftp: file 

DARPA Internet File 
/DARPA Trivial File 
/_tolower, toascii: 

tr: 

ftw: walk a file 

manage binary search 
trk: 

/asin, acos, atan, atan2: 
Protocol/ tftpd: DARPA 


constant-width text for 
text for nroff or 
typesetting view/ mv: a 
tables for nroff or 


trace. 

truth values. 

/u3b, u8b5, vax: provide 
true, false: provide 
system with/ Uutry: 
twalk: manage binary/ 
terminal inteface, and/ 


terminal interface. 
terminal. 

name of a terminal. 

in the utmp file of the/ 
terminal types by/ 

/a loadable driver for 
/shutacct, startup, 
tsearch, tfind, tdelete, 
file: determine file 

about your processor 
getty: set terminal 
uugetty: set terminal 
/list of terminal 

data types. 

primitive system data 
session. script: make 
graphs, and/ mmt, mvt: 
troff: 

/troff macro package for 


time/ /gmtime, asctime, 
truth/ mc68k, pdpll, 
mc68k, pdp1l, u3b, 
getpw: get name from 


limits. 
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tplot: graphics filters. . 
tput: query terminfo . . 
tputs: terminal/ ... . 
tr: translate 
trace. 
LACE: 6 ee ae ew 
transfer program. 

Transfer Protocol/ 
Transfer Protocol / 
translate characters. . . 
translate characters. . . 
tree. 
trees. /tdelete, twalk: . 
trekkie game. . . 2. © 
trigonometric functions. 

Trivial File Transfer . . 
trk: trekkie game. 
troff. /checkew: prepare 
troff. /mathematical . 
troff macro package for 

troff. tbl: format 
troff: typeset text. . .. 
trpt: print protocol .. 
true, false: provide .. 
truth value about your/ 

truth values. ..... 
try to contact a remote 

tsearch, tfind, tdelete, . 
tset: set terminal, 
tsort: topological sort. . 
ttt, cubic: tic-tac-toe. . 
tty: controlling 
tty: get the name of the 

ttyname, isatty: find . . 
ttyslot: find the slot .. 
ttytype: list of .... 
tunable variables. . . . 
turnacct: shell / 
twalk: manage binary/ . 
type. 
type. /truth value .. 
type, modes, speed, and/ 
type, modes, speed, and/ 
types by terminal/ 
types: primitive system 
types. types: 
typescript of terminal . 
typeset documents, view 
typeset text. 
typesetting view graphs/ 
TZ: time zone file. 
tzset: convert date and . 
u3b, u3b5, vax: provide 

u3b5, vax: provide truth/ 
UD. 
ul: do underlining. . . . 
ulimit: get and set user 


ftpd: 


ee 
ee ee we ee ew 
see 


oe © © © 
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tplot(1G) 
tput(1) 
termcap(3X) 
tr(1) 
ptrace(2) 
trpt(1NM) 
ftp(1N) 
ftpd(1NM) 
tftpd(1NM) 
conv(3C) 
tr(1) 
ftw(3C) 
tsearch(3C) 
trk(6) 
trig(3M) 
tftpd(1NM) 
trk(6) 
ew(1) 
eqn(1) 
mv(5) 
tbl(1) 
troff(1) 
trpt(1NM) 
true(1) 
machid(1) 
true(1) 
Uutry(1M) 
tsearch(3C) 
tset(1) 
tsort(1) 
ttt(6) 
tty(7) 
tty(1) 
ttyname(3C) 
ttyslot(3C) 
ttytype(4) 
mktunedrv(1M) 
acctsh(1M) 
tsearch(3C) 
file(1) 
machid(1) 
getty(1M) 
uugetty(1M) 
ttytype(4) 
types(5) 
types(5) 
script(1) 
mmt(1) 
troff(1) 
mv(5) 

t2(4) 
ctime(3C) 
machid(1) 
machid(1) 
getpw(3C) 
ul{1) 
ulimit(2) 


fe 


creation mask. 

mode mask. 

dismount file/ mount, 
system. 

current CTIX system. 
current CTIX system. 
ul: do 

an SCCS file. unget: 
spaces, and/ expand, 
get of an SCCS file. 
back into input stream. 
/leong48: generate 
lines in a file. 

mktemp: make a 
program. 

and unlink system/ link, 
entry. 

/exercise link and 
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profiler .....2.e.e.-. Se see 02% operating system profiler 
PISC G0 od tae ar es hee ees A he Se os SS os - . print an SCCS file 
DSiiar oe GaSe ep es ae nee. er tar le enna, S04 er We ee oe report process status 
DUK. y hacer Som te: So Sor cal, er tu jess JO cesar Bet cdl soe an sae Fond permuted index 
WOK oo she ee cah ok Sas avs eed password/group file checkers 
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PWd> v4 Hos Sot ee ee eR eb . « working directory name 


qmstall 2... 2. ee ee ee install and verify software 
qlist ..... pint out file lists from proto file; set links based on 
TOM” as." Fes Pe ee Be remote shell command execution 
PODS 26 Serie! whe: eda BER ee Se, ta » + + « « . Femote file copy 
TEDOOt) 20% bse QL Sa + + + « « « reboot the system 
TOSCMP? 16 6.25) Spot ve Han ata SH ne cer res Se regular expression compile 
renice .. . . . alter priority of running process by changing nice 
TOXCCA: decks eke el doe ie is eo: - «remote execution server 
PIOQING 2. ie) Blas ees Woes, B.'s ee oe ew ew ee © remote login 
TIO QING v5 -a-Ye 2, poke“ er ee GL ee - . remote login server 
WI 6 eS see eye es Sark OG Saye eae remove files or directories 
rmdel- ‘steeds ak be we ee remove a delta from an SCCS file 
TOUGE: teste 6-16 Pde pisos eo manually manipulate the routing tables 
TSH cs eters. ace cele Gee we ee ee - « » remote shell server 
rsterm .... mancally start and stop terminal input and output 
TUNACCE. ee ee ee Sele a ees es ee - . run daily accounting 


ruptime ...... . . display status of nodes on local network 
rwho..... +... « « » Who is logged in on local network 


rwhod ..... Sins let Sols leap enetemte SO “> . . . node status server 
saci... ..... . . ~ print current "sccs file editing activity 
BADD 8 ee ael ls: eee we + es 6 e 6 © . disk access profiler 


BAB oo sis, 30 eee ee een wl Bs eB ce . system activity graph 
SAL se 6 ee ee we ew we ww we . SYStEM activity reporter 
Sari. se ee ee ew ew we we ~~ SYStEM activity report package 
seesdiff . ..... .. . » compare two versions of an SCCS file 
script... ... +... ». make typescript of terminal session 
sdb «6. ee ew ee ww ew we we we © «Symbolic debugger 
sdiff ... 2... ..... « « Side-by-side difference program 
sed «oe wee ee we we ew we we we we ww so Stream editor 
setaddr .... . .set DARPA Internet address from node name 


Setenet: 0s 6 se wl ee A as write Ethernet address on disk 
setmnt . . 2... 6 2 © 6 we © we ew © © eStablish mount table 
SCtUNAMNE oven ei ws er eee Se ea a - . Set name of system 
sh . shell, the standard /restricted command programming language 
SI) ceri 9) os eee ah We eRe Oh ep See - . . . Shell layer manager 
shutdown .. 1.2. ee ee ae 26 . terminate all processing 
SIZE 2. sw ee + « «print section sizes of common object files 
slattach... . titach and detach serial lines as network interfaces 
SICCP ws. he We oa! ce: hee Ta ve suspend execution for an interval 
SOF 4) eh igen aa ase fos es aS ee . - sort and/or merge files 
spell’, 3 Ay add ied S. ethene, A Beer sty find spelling errors 
SPLINE! © say. 8 ee Mam wiht fe nee SS vente . interpolate smooth curve 
SDI 6. ea ee eee ees G's - . » . Split a file into pieces 


stat .... . statistical network useful with graphical commands 
strings ..-...-... . . extract the ASCII text strings in a file 
strip ...... » . . strip symbol and line number information 
stty . 2... 2.2.2.2... . Set the options for a terminal 
SU. ss ee e + © ww ee  » BECOME SUper-user or another user 
sum ....... . . . print checksum and block count of a file 
SWAP) oa ee ee ee a . swap administrative interface 
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SYNC%s- 6: Salen we a ae eee eS update the super block 


GAS! sate See iet SS Sei wset af ee bcos dal dae Si Be set tabs on a terminal 
Valle oN egies we Shy eles fogs bee ns deliver the last part of a file 
VATS fe spay bah MF oh cote Aa’ alas iShcce see ee Mes Serie, tas oe . tape file archiver 
tbl . 1... 2 6 ee ee ee © format tables for nroff or troff 
Cetus. eo Se hee Oe be GR es Bee RS-232 terminal download 
LOX . eer, loa i rca cay the petyen dato toy sen Suh teh age esaee - + . pipe fitting 


telnet. . . 2. 2. ew we] . user interface to TELNET protocol 
telnetd. . 2... ~~... « » DARPA TELNET protocol server 
COS ae hee te Ba ene en ee condition evaluation command 
titp .... .. . . user interface to the DARPA TFTP protocol 
titpd .... .. «DARPA Trivial File Transfer Protocol server 
tC: ei cee Goa ae eel eet aie, Chas tate . . . terminfo compiler 
TUITE soi et. Sica ve cae A fortes We) toes Son wwe lg eet el ae . time a command 
timex . . Gini: a command: report process data ana system activity 
toc. . 2. «s+ se 6 « © « . graphical table of contents routines 
touch . .... . . update access and modification times of a file 


Blob ee cb cad Say: wp sar Ae ei ow, moet “ge in ory Les hes ee Sek - graphics filters 
DUG eS 6 25 io 26 Lda) Tate, Fe tah Lk em taht fe Ya 26, a A query terminfo database 
BE nse a Fa el Te He Bi oes Sat so a? ne . . translate characters 


GEOLE® Sole bet aise Sea eek wee Se ' Seceloie cae cee bypesebs text 
trpt 6 6 ee ee ew ee we wee ee dprint protocol trace 
true... 6 oo oe ee ew ew ew ee provide truth values 
tset . . . set terminal, terminal inteface, and terminal environment 
GeO Sai goes bale och ose oe Weis. 0 ork bOpoleeicaleort 
tty. 2 ww ee ee ew ee «get the name of the terminal 
Ul eo be oe ee ee ee ae oe ww dO underlining 
umask... 2 6 1 6 we we ew © Set file-creation mode mask 
uname ...... .. . . . print name of current CTIX system 
unget ...... +... .undoa previous get of an SCCS file 
uniq «. 2. ee + ew ee ws © «report repeated lines in a file 
units . 6 6 ee we we ee we ew ee  CONVEFSION program 
Update: soc Se Seo caysds eds ee we es provide disk synchronization 
uucheck .... heck the UUCP directories and Permissions file 
uucicoO . . . « . COpy- se -out program for the UUCP aon 


uucleanup . 2... 2 we ew ee we uucp spool directory clean-up 
wucp . 6 eee ew ew ee.  CTIX system to CTIX system copy 
UUCD: ca) osoce, wei ay wel is Aes 80. CS see ay, Gel Se er Ge For ne network uucp server 
uugetty ... at terminal type, modes, speed, and line discipline 
UUIO Rs co Sah ee sel ler a ee Des ter ey sds Se output logfile information 
UUNAMEC oie ce ee ee ee ee list UUCP system names 


uusched ....... . . . the scheduler for the UUCP system 
uustat ..... +... - . . uucp status inquiry and job control 
WUSUD!: ope Se, eee ce Oe Genie eee? A oe monitor uucp network 
uuto. .... + » » » . public CTIX-to-CTIX system file copy 
Uutry .... ties to contact a remote system with debugging on 
wux . 2... e+ « © » CTIX to CTIX remote command execution 
uuxqt . « . 6 « © ee © we . execute remote command requests 
Vale sed ee ae, bk Ja, Ses we She A ayes validate SCCS file 
VCP aly Ai pe achat. ier Yes Goa tem regar Wem a eta 7 - « » . Version control 
2 ee eee  seteen-oriented (visual) display editor based on ex 
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volcopy ..... +... - - copy file systems with label checking 
Walt. 2 2 6 ee ee ww ee we] e Await Completion of process 


Wall, 9 eo. es Boece ie Gee we Gl er ee - . - « » . write to all users 
WG: a vas tees Sepciar Genrer estou) <es-tdS oe: Gelb ve + « » word count 
WAU: wie YS eel nat a> Se: Behn, Gy ee ve std dea oe identity SCCS files 
WHO a5 oe Nee ipa Sat hate Ses. fet ees eo ie ate _AMhoasou thereon 
HOGS cong ei hea ALE caeratas eb ale WHO Iscdoinecw hat 
WI cer ee var bial Sera WS ae te » . » . window management 
WIICG  <e2 Sai ie: bi Yon Ow or Sei via Se Levees va, Wee . « . write to another user 
XargS 2. ee . construct argument list(s) and execute command 
xmset set drive parameters for Xylogics 772 half-inch tape controller 
xstr .... 4... . . . extract and share strings in C programs 
VACC so Sr ee. Gara WI EES we yet another compiler-compiler 
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Administration 


Accounting and Profiling 

acct . . . overview of accounting and miscellaneous accounting commands 
acctems .. . . «command summary from per-process accounting records 
acctcom ....... +. « «search and print process accounting file(s) 
acctcOn 6 6 ew ew ee ee ew we we ew 2 CONNECH-time accounting 
acctmerg . . «+ « + © © © os © © + Merge or add total accounting files 
acctpre 2 eee ww we ew we ew we ew we ww © process accounting 
acctsh 2. 6 2 0 6 we et ow ee @ © © Shell procedures for accounting 
fwtmp . «2 « 6 «© © «© © © © © + Manipulate connect accounting records 
prof. eee ee ee ee hw ee we ew ww we ww wf Gisplay profile data 
runacct 2 6 2 6 ee ee ee ee ee ew we oe © un daily accounting 
Sar ww ee ww tt et we we te ww wh we ww  / SYStEM Activity reporter 
Sar we wt ww tw wt ww ww ow ww © SYStEM activity report package 


Backups 

ff 2 2 « © © ww ew © © © © list file names and statistics for a file system 
finc 2 6 ee we ww we ew we we ww we ww ew f fast incremental backup 
frec es se ee ee ww ee ew we we ww © recover files from a backup tape 
volcopy . + + 6 «© « © © © « © © © « copy file systems with label checking 


Controlling System State 

bre ss 6 ww ew ww ew ww ww we © / SYStEM initialization shell scripts 
crash «2s ew ee we we ee we ww we ww ww . CXAMINe System images 
getty . . . . «+ « « » Set terminal type, modes, speed, and line discipline 
init 2 2 ew ww ew ww we ww ww ee © ~ process control initialization 
killall 2 2 ew ew ww ee we we ww ww ww ~ kill all active processes 
login 2 6 ww we ee we ee ee ww ww we we we wh ww ww wo SIGN ON 
shutdown » 2 6 se ee ee we ew eo ow © © terminate all processing 
wall «0 ee eee we ee we we te ww ew ww ww © w Write to all users 


Disk Management 

beopy 2. 6 6 we eee eee ee we te ee et « interactive block copy 
Clri gw ww eet ww te ww twee we tw to ww o_o Clear i-node 
dcopy . . +. «+ « « « © © ~ « copy file systems for optimal access time 
devnm 2 6 ee ew ee ee ee ee ee wh ww we ww ww ® o Kevice NAME 
df. 6 ew we we ww ew we we © © Feport number of free disk blocks 
fsck » « «+ + + « © ~ file system consistency check and interactive repair 
fsdb 5 6 we ew ww we we ew www wh ww ww ww o file system debugger 
fuser . . . « « + «© « © «© « identify processes using a file or file structure 
link » 2 6 6 we ew we ww we es fe exercise link and unlink system calls 
mkfs «6 6 ee ee ew ee ew ee we we we ee © | Construct a file system 
mklost+found ..... +... . .makea lost+found directory for fsck 
mount «. 6 6 « «6 «© «© © © « © © @ © ~ MOUNt and dismount file system 
mydir 6 6 ew we ee ee ee ew we ww ww ww ws move a directory 
ncheck . 2... 4 6 we eo we © we © ~ © generate names from i-numbers 
setmnt 2 2 2 2 2 ee ee ww we oe ew we @ © eStablish mount table 
SYNC 2 2 6 wo ew we ww ww ww ww ww wf © Update the super block 
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General 

conlocate . . . . . . locate a terminal to use as the virtual system console 
config. 2 2 6 se ww ew we ew ew we © © © configure a CTIX system 
cpset «6 se ee ee ee ee © ~ install object files in binary directories 
CTON 6 ew we eee ew we hw ew we ww ww et ww « Clock daemon 
dismount . . - 2 ee © « e © © w © © © remove floppy or cartridge disk 
errdead .. . . . extract error records and status information from dump 
errdemon «ee ee ee ee ee we ew we eo ww ew © eFror-logging demon 
errpt « 2 ee ew ew ew ee ow oe © © process a report of logged errors 
errstop « - «6 «© 6 © © ew ew ew © © terminate the error-logging daemon 
install » 6 0 2 ew we ee ee we ee we ew we ww ww install commands 
IV ww ee ew ww ww we ww ww ee |  iitialize and maintain volume 
mknod 2. 0 ee we ee ee ew ww ew ww ww wf © DUild Special file 
path . 2. 6 ee ww ww ww we @ « locate executable file for command 
PWR 6 ee we eee we ew we ww © ~ password/group file checkers 
rsterm . . .. + « « - manually start and stop terminal input and output 
setumame « «es ee © we oe ww ew tw ew we ww wf Set Name Of system 
update 2 2 2 6 ee we ew ew we ww we © © provide disk synchronization 
whodo «ee 6 6 ee ew ee ww we we we ww © « WhO is doing what 


Interprocess Communication 
iperm . . . «remove a message queue, semaphore set or shared memory id 
ipes 2. « « » «© «© « » © report inter-process communication facilities status 


Basic File Commands 


Cat wwe we ee we we we ew ww ee concatenate and print files 
chmod . 6 ee ee ee we we we ww ww ww ww ww ww @ © Change mode 
chown «6 6 ee ee ew ww ww we ww oe ww © Change owner or group 
diremp «6 1 6 se ee ww ew we we ww ww © @ directory comparison 
Cl ie ee eo we ee ew ww we ww we ww ww © © COpY, link or move files 
dd . ee we ee ew we ww we we ww ww we ww ~ cONnVErt and copy a file 
file. cw we ee we we ee ewe ew ww ww © « determine file type 
Pith oie cielo wie ae a wk etch! Se en Ew ah eee’: “ot vestind files 
IS we ew we wwe ee wt we eh ww we we ew ~ list contents of directory 
PWH ce ww we ww ew ww et ww ww oe oe © © WOrking directory name 
mkdir 6 6 ee ee ee ew ee we ww we wo ww © make a directory 
TM ow ew ee ew ew we ww ww we ww ww remove files or directories 
umask 6 2 ee ew ew we we we we we we ww 5 Set file-creation mode mask 


Basic General Commands 


calendar «6 6 0 we ew we ee ew we ww we ew ww ow © TeMINder Service 
date. 2 ew ee ew we we we ew we we wh ww ee print and set the date 
id 2 ue ww ew ww we ew we we © © © print user and group IDs and names 
Kil. we we ew ew ee ewe we ww hh we ws ft terminate a process 
logname «2. 6 2 ee ee ew ew we th ew tw we ww © Bet login name 
NEWEIP os 6 ee we ew ww ew we ew we ee ee LOG in to a NeW group 
NEWS oe we ee we ee wh www eh ww we ww ww print news items 
passwd 2 we ww ew ee ee ww ew ew ee © © Change login password 
PS 6 © se ee eo ow we ew ee ew wh ww ww ew we e FEport process status 
uname « . 6 6 © ee ew we ww ew ew ww © print name of system 
Who 2. 6 ew ee ee ww ee ew ew we te we © © © Whois On the system 


Communication Between Systems (uucp) 


Ch we we we ew ew wt ww ww ] Spawn getty to a remote terminal 
CU ww ee we ww we we ew ww ow ww Call another computer system 
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uucheck ... .. . . . check the UUCP directories and Permissions file 
uucico . . . ss + « « copy-in/copy-out program for the UUCP system 
uucleanup 2. ee ee ee ee ee ee © © UCP Spool director clean-up 
UUCP - 2 ew ee we ww ew ew ee ee CTX system to CTIX system copy 
uugetty . . . . . . . .set terminal type, modes, speed, and line discipline 
uulog. 6 2 6 ee ew ew te ew ww ww es 2 OUtput logfile information 
uuname » 2 ee 6 ee ew ew ew ew oe oe we f list UUCP system names 
uusched . . 2s ee ew ee ee © « the scheduler the the UUCP system 
uustat 2 6 6s 6 ee ee ee we ee © UUCp Status inquiry and job control 
uusub 2 6 6 ee ee ww we we eh we we ee ©  @ MONItor UUCcp network 
uuto . . . . « . « » public computer system-to-computer system file copy 
Uutry . . . . . 2. . . try to contact a remote system with debugging on 
UUX 6 6 6 ew ww ww ew ww ee CTIX to CTIX remote command execution 
uuxqt . 6 2 6 © 6 ww ew ww ow we «execute remote command requests 


Communication Between Users 


mail . 2 6 2 6 ee ee ww we © © © © «Send mail to users or read mail 
mailx . 2. «© © « « « «© » « ~ / interactive message processing system 
mesg «2 6 ww ew ee ew we we ww ew ew © » permit or deny messages 
write 2. 2 2 ee ew we ew ew ww ew ww we ww ow » Write to another user 


Document Formatting and Checking 


col ww we et we th he ew te th te ww ww w o filter reverse line-feeds 
CW ee 6 we ew we ww ww ow ow © @ prepare constant-width text for troff 
deroff . . . 2 ss « «© © « © / remove nroff/troff, tbl, and eqn constructs 
du. ew ew we we ww we ew ww ww ww we we oe / SUMMarize disk usage 
eqn « « 6 ee ee ee ee ~~ format mathematical text for nroff or troff 
greek 2 ew ew ee we ee ewe ww eh we ww ow ow © Select terminal filter 
hyphen «6 ee ee ee ee we ew ew ew we es | find hyphenated words 
mm... « print/check documents formatted with the MM macros 
mmt . «+ «+ «+ « «+ + © « typeset documents, view graphs, and slides 
mroff 2 6 6 ee es ee te ew ww ww ow ww we ww «© format text 
PtX 6 we www ww ew we we we we we ww ww we ww © © permuted index 
spell 2. 2 0 we ew ee ee we we te we we we ww ww © find Spelling errors 
tol. 2 2 6 we ew ee ww we ww ew ww f fOrmat tables for nroff or troff 
GROPP so celal ie fe oe 6s sew tay eee, ee, Ne fal de: vote Jao oh fee ap pe by peset-text 


Internetworking Tools 


ftp 2 ee ee ww ew we we we ew we ww ww ow « file transfer program 
ftpd . 2. . «© «© « « « » » « DARPA Internet File Transfer Protocol server 
ifconfig . . . +». + « + » » - «configure network interface parameters 
mkhosts . 2. 2 2 «6 © «© © e «© © w © «© «make node name commands 
netman . 2 « « « © © © © «© © «© © © © form-based network management 
netstat 2 2 2 6 6 eo 6 ee we we we ww ew we ew @ © SHOW Network status 
roemd . 2 2 6 © oe we ew we ww we © remote Shell command execution 
TCP ee ee we ew ew wt we ew we ew we ww ww © @ FeMOte file copy 
rexecd 2 2 se ew ee ew ee ew ww ww ww © PeMOte execution server 
Tlogin 6 6 ee ew ee ee we ee ww ew ww ww ww ow © TEMOte login 
Tlogind £6 0 6 ew ew ww we we we ww ww ww © © remote login server 
route . 6 6 6 2 © ew ww ww we we ww we © © remove files or directories 
tTshd . 2 2 we we we ew we ee www ew ew we es remote shell server 
ruptime ....... +... «display status of notes on local network 
TWhO. . © oe © we © oe we ew © © © ©» Whois loggin in on local network 
rwhod. . 2. 2 ee ee ee eo oe we we we we ww we «NOE Status Server 
setaddr . ...... =. Set DARPA Internet address from nodename 
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setenet . 2 6 6 2 2 oe © w © ee ew ee » Write Ethernet address on disk 
slattach . 2... ...... . «attach serial lines as network interfaces 
sidetach 2... ... +... «detach serial lines as network interfaces 
telnet «2 ee ew ee ee we «User interface to TELNET protocol 
telnetd 2... 6. 2. «© «es ~ © « DARPA TELNET protocol server 
tftp... 6 6 ee we es . user interface to the DARPA TFTP protocol 
titpd ..... =... =. . «DARPA Trivial File Transfer Protocol server 
trpt 2 6 we we we ee ee tw we ew we we © print protocol trace 


Mathematics Tools 


be «eee eee we ee ee © . arbitrary-precision arithmetic language 
GC ee eee wee eww eee ee ee wee ee ct « « desk calculator 
(edkOh opcode ence gee ee acu le ne 
spline «2 ee we ee we ew we we ww ww | « interpolate smooth curve 
units 6 6 ew we eee ww we ew ww ww ww © © CONVEFSION program 


Miscellaneous 


Man «ee ee eo we we ew ww ew ew ew ww print entries in this manual 
Mog ew eee eee ew we we we ww we ww wf bine numbering filter 
pack . 6 2 0 6 ee ee ew ew ww we ew @ « cOMpress and expand files 
script «2 2 6 6 « «© © © © © © @ @ » make typescript of terminal session 
SU 6 6 ww ew we ww ww ww ew © © DECOME SUpPer-user or another user 
WO se 6 oe © we we ww th we tt tw ew 8 tw ww wo ow ow 6 WOrd count 


Offline Storage 


CPO 6 ww ew ew ww ww ew wo ww @ © COpY file archives in and out 
tare cw ee ee ee ee te we ee ww we ww ww « tape file archiver 


Printer Spooling 


accept » se ee te ww we ew ew ww oe  « ~ allow/prevent LP requests 
enable . 2 6 se 0 ew ee we we we ww © © enable/disable LP printers 
Ip 2 2 eee ew ew ew we © ~~ Send/cancel requests to an LP line printer 
Ipadmin . «se ee eo we ew © © © configure the LP spooling system 
Ipr we we ewe ew ew www ww we ww ww ww © line printer spooler 
Ipsched . . .. . «start/stop the LP request scheduler and move requests 
Ipset «0 ew ww we ew ew we ww © © Set parallel line printer options 
Ipstat. 2 2 6 ww ew ww ew we ww oe ww © print LP status information 


Program Development 


adb see ew we ee we we we ww ww ww ww © « abSOlute debugger 
ar. «+e « « « « « ~ archive and library maintainer for portable archives 
BSc eee ee we ee we we we ww ww ww oe ew we MCHROIO assembler 
Ch ew we ew ee we ww ew ee we ww ww ee © program beautifier 
Coe se ewe ees wane eo we we he te oo ww ow os oe © compiler 
Clow 6 we we ee ww ee ww ew ow ww  ~ generate C flow graph 
CPP ew ew ew we ww ew we we ww tw ww the C language preprocessor 
ClLags 6 ew ww ee we we ww we ww ew ww ww ww fo create a tags file 
cxref . 6 6 © © © © ow ew oe oe wo e generate C program cross reference 
dump « . ee «© © ee oe ew © © © © dump Selected parts of an object file 
fsplit . 2. 2 2 2 ee ww we we ee Split fortran, ratfor, or efl files 
hd «ee ee ww ww wee ew we ow @ © hexadecimal and ascii file dump 
Id we we wwe ee we ww ww © link editor for common object files 
int. 2 0 ee ee ee ee ee ee hw wo ow oe © © AC program checker 
lorder . 2. 6 « © «© » + © © ~ find ordering relation for an object library 
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m4. 6 eee we ee ee ee ee ee ee ew macro processor 
make... . .. . .maintain, update, and regenerate groups of programs 
MM. 2 ee. eee ee ew ee | © print name list of common object file 
Od ww ee wee ee eee eee eee ee ee ee  . Octal dump 
TEgCMP 6 2 ee we oe we ew ew we ew © © regular expression compile 
SIZE. 6 ew ee we ew oe ee ee print section sizes of common object files 
strings... 6... +. +. . «extract the ASCII text strings in a file 
strip . strip symbol and line number information from a common object file 
time 2 6 ew ee ee et we ee ew ww we we es time A COMMand 
timex. . . . . . time a command; report process data and system activity 
touch... « .... . . . update access and modification times of a file 
{SOFE gw ew ee ew ewe ee ew ew ww ww © topological sort 
xXStr . 0 6 2 0 ee ee ee © | f extract and share strings in C programs 


Source Code Control System 


admin . 2 2 2 6 2 ee oe ow oe ew ww © Create and administer SCCS files 
cdc» . « « « © « + « « « change the delta commentary of an SCCS delta 
comb. 2 2 ee ee we ee ew ww ww we wo ee Combine SCCS deltas 
delta . 2 2 6 ee ee ee © «  « makea delta (change) to an SCCS file 
Bebe ww ww ee wee we ee ee ew ee of Bet a Version of an SCCS file 
help 2s eee eee een eee ee eo ow ow ww « wo ask for help 
PIS oe ew ew we ee ew th ot wo wo wt ww eo wo print an SCCS file 
rmdel . ee 6 2 ee wo ee we we | Femove a delta from an SCCS file 
sact 6 2 2 ee 2 ee eo ew we print current SCCS file editing activity 
secsdiff. . 2 . 2 « © «© « se « « « compare two versions of an SCCS file 
unget . - ee 6 © © ee © © © ee «Undo a previous get of an SCCS file 
val ow wee we we we we ww ww ww ww ww  « Validate SCCS file 
VO we ew we we ee hw ee we ww ew ww ww ow © « Version control 
what 2 6 0 0 ew we ew ee we ee ew ww we © identify SCCS files 


Terminal Support 


300... . . . ~ handle special functions of DASI 300 and 300s terminals 
4014 .....-. =... . « paginator for the TEKTRONIX 4014 terminal 
450...» . ... « « handle special functions of the DASI 450 terminal 
ASA 2 6 ee oe ew ee ee interpret ASA carriage control characters 
clear 2 ew we we ee we we we ww we ww ww ww © Clear terminal screen 
hp ... . . handle special functions of HP 2640 and 2621-series terminals 
SttY 2 0 ee ew ww ew ww te we ww ws 2 Set the options for a terminal 
tabs «0 ew ww ee ew tw oh ww ww ww ww © SOt tabs On a terminal 
tdh 2 6 ee ew ee ee ee ee ww we ww 2 £5232 terminal download 
tic ce ww ee ee we ww ww ew ww ww ww © © terminfo compiler 
tset ... . . . Set terminal, terminal inteface, and terminal environment 
tty. 2 ew ew ee we we ew ww ew ew ww © Bet the terminal’s name 
WM 6 ww we ee ee ew ww ew tw ww we © WWINdOW Management 


Text Tools 


Browsers, Editors, and Splitters 

bis 6 we ew wee we we we we we ew ww we « big file scanner 
esplit 6 ew we we we ee we ee ee we ww ww © ~ cOnteXt Split 
Cds 8 eo ee ee He ee Be eee ee ee we ow text editor 
CX we ce we ee ee ce ew www we te ww ww ww ow ww o text editor 
MOre 2 eee ee ee ee ee we ee ww ew we we ww ww © LEE perusal 
newform . . 2... ses.» +s «© «change the format of a text file 
PRs ee ee ew we we ee © ~ file perusal filter for soft-copy terminals 
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split 2. 6 ee eee ee te ew ee ew we we oe | Split a file into pieces 
View se ee we ew © . Screen-oriented (visual) display editor based on ex 


Comparing Files 

Pith sci Fete se ail oie Sings ita, eh Wie Td ay a 8 ee iS ge Pere So SDI 
CMp 2 ee ww ee we we hw ee et tw ww ww ef COMpare two files 
comm ...... -. . «Select or reject lines common to two sorted files 
diff 2. 6 ee ee ew tw we ew ee ew © © Aifferential file comparator 
GiffS . 2 ee ww ww we we we ee way differential file comparison 
diffmk . 2. 2 6 2» ww we we we «ej mark differences between files 
sdiff . 2 6 eww ee we ww ww ww ww © Side-by-side difference program 
Customizable Filters and Text Programming Languages 

awk «2.4 + 6 «© + «© » © © « © pattern scanning and processing language 
cut 2. 2 ew ww we ww ew © / Cut OUt Selected fields of each line of a file 
fold . 2. . 2 6 « « « «= « « « fold long lines for finite width output device 
STEP ww we ww we we ee we we we ww © Search a file for a pattern 
Join 2 2 ww we ww we we we ww we we © «relational database operator 
lex . 2 2 2 oe eo we ww oe we © BeNerate programs for simple lexical tasks 
paste . . . «merge same lines of several files or subsequent lines of one file 
PE ie On eS ei ow ee A eS we Ow ew we ee print-files 
sed on ew ee wee wee te et ww ee ee ew ew ww Stream editor 
Sort. we ee ee we we hee we ww ew ww © oe SOrt and/or merge files 
tall 2. 6 6 ew we we ww we ww ww ww « Oeliver the last part of a file 
trig ww ee ew ee we wh we th we we we ww ow © fw translate characters 
uniq . 2 0 6 ew ee we ww ww ww ww © POport repeated lines in a file 
Yace ve ee ee we we ew we we ww ee yet another compiler-compiler 


Graphics and Displays 

banner 6 ee we ww ew ww we we ww we ww ww ww wo © make posters 
cal wwe we we tw ww ww wt hw we th ww ww ow oo © print calendar 
graph «oe ew we ewww ees wee oe ww oo ow ow o raw a graph 


Using and Programming the Shell 


basename . «2 2 ee oe ee ww ew ee © © deliver portions of path names 
chroot « « «4 « © «© © © «© © « » » Change root directory for a command 
Cd ww ww ww ww ww ww ww ww ww ef « Change working directory 
echo 2 ee ew ew ee we we we ew wh we ww we oe ww we / ECHO arguments 
CNV 2 2 a ee we we oe we we Seb environment for command execution 
CXpr oe « © oe ew ow ee ww ew wo CVAlUAte arguments as an expression 
getopt 2. 6 6 ee ww we ew ww ww we ow © © parse command options 
line 2. oe ee we we we ew wo ww wo hw wh we ow ww ow ow « read One line 
machid 2. 6 0 «© 0 ee eo we we we eh ww ww wh ww ww © processor type 
NICE se oe we eh ew ew we we we ww we ee PUN A CcOMMand at low priority 
nohup ......-.. «run acommand immune to hangups and quits 
sh... . «Shell, the standard/restricted command programming language 
sleep. 2 2 2 ew ee ee ww we we we @ SUSpeNnd execution for an interval 
tee 2 we ew ew we wwe ew eet ww et ww we tw ow ow on pipe fitting 
test 2 6 0 8 ew ee ew ew ew oe we we © Condition evaluation command 
true. «ee ew ee we tw oe tw we ww we we ww © provide truth values 
wait 2 6 2 ww ee ew we we we eh ww we @ / Await Completion of process 
XargS. » + » © © « © « «construct argument list(s) and execute command 
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INTRO(1) 


NAME 
intro - introduction to commands and application 
programs 

DESCRIPTION 
This section describes, in alphabetical order, publicly- 
accessible commands. Certain distinctions of purpose are 
made in the headings: 


1) Commands of general utility. 
1C) Commands for communication with other 
systems. 


(1G) Commands used primarily for graphics and 
computer-aided design. 

(1M) Commands for system maintenance and 
administration. 

(1N), (INM) 
Commands for the CTIX TCP/IP networking 
packages. To use these commands you must 
have a special version of the CTIX kernel that 
supports TCP/IP. 


COMMAND SYNTAX 
Unless otherwise noted, commands described in this 
section accept options and other arguments according to 
the following syntax: 


pater loption(s)) [emdarg(s)| 


name The name of an executable file. 
option — noargletter(s) or, 
— argleiter << >optarg 


where <> is optional white space. 


noargletter A single letter representing an option 
without an argument. 


argletter A single letter representing an option 
requiring an argument. 
optarg Argument (character string) satisfying 


preceding argletter. 
emdarg Path name (or other command argument) 
not beginning with — or, — by itself 
indicating the standard input. 
SEE ALSO 
getopt(1), exit(2), wait(2), getopt(3C). 
Section 6 of this volume for computer games. 
How to Get Started, at the front of this volume. 
DIAGNOSTICS 
Upon termination, each command returns two bytes of 


S 
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status, one supplied by the system and giving the cause 
for termination, and {in the case of “normal” 
termination) one supplied by the program (see wait(2) 
and ezit(2)). The former byte is O for normal 
termination; the latter is customarily O for successful 
execution and non-zero to indicate troubles such as 
erroneous parameters, bad or inaccessible data, or other 
inability to cope with the task at hand. It is called 
variously “‘exit code”, ‘“‘exit status’, or “return code’’, 
and is described only where special conventions are 
involved. 


BUGS 
Regretfully, many commands do not adhere to the 
aforementioned syntax. 

WARNINGS 


Some commands produce unexpected results when 
processing files containing null characters. These 
commands often treat text input lines as strings and 
therefore become confused upon encountering a null 
character (the string terminator) within a line. 


300(1) 


NAME 
300, 300s — handle special functions of DASI 300 and 
300s terminals 


SYNOPSIS 
300 [ +12 ] [ -n ] [ —dt,l< ] 


300s | +12 | [ -n ] [ -dt,l,c ] 


DESCRIPTION 

The 800 command supports special functions and 
optimizes the use of the DASI 300 (GSI 300 or DTC 300) 
terminal; 800s performs the same functions for the DASI 
300s (GSI 300s or DTC 300s) terminal. It converts half- 
line forward, half-line reverse, and full-line reverse 
motions to the correct vertical motions. It also attempts 
to draw Greek letters and other special symbols. It 
permits convenient use of 12-pitch text. It also reduces 
printing time 5 to 70%. The 800 command can be used 
to print equations neatly, in the sequence: 


neqn file ...| nroff | 300 


WARNING: if your terminal has a PLOT switch, make 
sure it is turned on before 300 is used. 


The behavior of 800 can be modified by the optional flag 
arguments to handle 12-pitch text, fractional line 
spacings, messages, and delays. 


+12 permits use of 12-pitch, 6 lines/inch text. 
DASI 300 terminals normally allow only two 
combinations: 10-pitch, 6 lines/inch, or 12- 
pitch, 8 puesta To obtain the 12-pitch, 6 
lines per inch combination, the user should 
turn the PITCH switch to 12, and use the +12 
option. 


—n controls the size of half-line spacing. A half- 
line is, by default, equal to 4 vertical plot 
increments. Because each increment equals 
1/48 of an inch, a 10-pitch line-feed requires 8 
increments, while a 12-pitch line-feed needs 
only 6. The first digit of n overrides the 
default value, thus allowing for individual 
taste in the appearance of subscripts and 
superscripts. For example, nroff half-lines 
could be made to act as quarter-lines by using 
—2. The user could also obtain appropriate 
half-lines for 12-pitch, 8 lines/inch mode by 
using the option —3 alone, having set the 
PITCH switch to 12-pitch. 
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—dt,l,c controls delay factors. The default setting is 
—d8,90,30. DASI 300 terminals sometimes 
produce peculiar output when faced with very 
long lines, too many tab characters, or long 
strings of blankless, non-identical characters. 
One null (delay) character is inserted in a line 
for every set of ¢ tabs, and for every 
contiguous string of ¢ non-blank, non-tab 
characters. If a line is longer than / bytes, 
1+(total length)/20 nulls are inserted at the 
end of that line. Items can be omitted from 
the end of the list, implying use of the default 
values. Also, a value of zero for ¢ (c) results 
in two null bytes per tab (character). The 
former may be needed for C programs, the 
latter for files like /ete/passwd. Because 
terminal behavior varies according to the 
specific characters printed and the load on a 
system, the user may have to experiment with 
these values to get correct output. The —d 
option exists only as a last resort for those few 
cases that do not otherwise print properly. 
For example, the file /etec/passwd may be 
printed using —d3,30,5. The value —d0,1 is a 
good one to use for C programs that have 
many levels of indentation. 


Note that the delay control interacts heavily 
with the prevailing carriage return and line- 
feed delays. The stty(1) modes nlO er2 or nlO 
er3 are recommended for most uses. 


The 800 command can be used with the nroff —s flag or 
rd requests, when it is necessary to insert paper 
manually or change fonts in the middle of a document. 
Instead of hitting the return key in these cases, you must 
use the line-feed key to get any response. 


In many (but not all) cases, the following sequences are 
equivalent: 


nroff —T300 files... and _ nroff files ...| 300 
nroff -T300-12 files... and _ nroff files... | 
300 +12 


The use of 300 can thus often be avoided unless special 
delays or options are required; in a few cases, however, 
the additional movement optimization of 300 may 
produce better-aligned output. 
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The negn names of, and resulting output for, the Greek 
and special characters supported by 800 are shown in 
greek(5). 


SEE ALSO 


BUGS 


450(1), eqn(1), graph(1G), mesg(1), nroff(1), stty(1), 
tabs(1), tbl(1), tplot(1G), greek(5). 


Some special characters cannot be correctly printed in 
column 1 because the print head cannot be moved to the 
left from there. 


If your output contains Greek and/or reverse line-feeds, 
use a friction-feed platen instead of a forms tractor; 
although good enough for drafts, the latter has a 
tendency to slip when reversing direction, distorting 
Greek characters and misaligning the first line of text 
after one or more reverse line-feeds. 


4014(1) 


NAME 

4014 — paginator for the TEKTRONIX 4014 terminal 
SYNOPSIS 

4014 | -t ] [| -n ] {| -eN } [ —pL ] [ file | 
DESCRIPTION 


The output of 4014 is intended for a TEKTRONIX 4014 
terminal; 4014 arranges for 66 lines to fit on the screen, 
divides the screen into N columns, and contributes an 
eight-space page offset in the (default) single-column 
case. Tabs, spaces, and backspaces are collected and 
plotted when necessary. TELETYPE Model 37 half- and 
reverse-line sequences are interpreted and plotted. At 
the end of each page, 4014 waits for a new-line (empty 
line) from the keyboard before continuing on to the next 
page. In this wait state, the command !cmd will send 
the cmd to the shell. 


The command line options are: 


—t Do not wait between pages (useful for directing 
output into a file). 
—n Start printing at the current cursor position and 


never erase the screen. 


—ceN Divide the screen into N columns and wait after 
the last column. 


-pL Set page length to L; L accepts the scale factors 
i (inches) and | (lines); default is lines. 


SEE ALSO 


pr(1), te(L), troff(1). 
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450 — handle special functions of the DASI 450 terminal 


SYNOPSIS 


450 


DESCRIPTION 


The 450 command supports special functions of, and 
optimizes the use of, the DASI 450 terminal, or any 
terminal that is functionally identical, such as the 
DIABLO 1620 or XEROX 1700. It converts half-line 
forward, half-line reverse, and full-line reverse motions to 
the correct vertical motions. It also attempts to draw 
Greek letters and other special symbols in the same 
manner as 800(1). Use 450 to print equations neatly, in 
the sequence: 


neqn file ... | mnroff | 450 


WARNING: make sure that the PLOT switch on your 
terminal is ON before 450 is used. The SPACING switch 
should be put in the desired position (either 10- or 12- 
pitch). In either case, vertical spacing is 6 lines/inch, 
unless dynamically changed to 8 lines per inch by an 
appropriate escape sequence. 


Use 450 with the nroff —s flag or .rd requests when it is 
necessary to insert paper manually or change fonts in the 
middle of a document. Instead of hitting the return key 
in these cases, you must use the line-feed key to get any 
response. 


In many (but not all) cases, the use of 450 can be 
eliminated in favor of one of the following: 


nroff —T450 files ... 
or 
nroff —T450-12 files ... 


The use of 450 can thus often be avoided unless special 
delays or options are required; in a few cases, however, 
the additional movement optimization of 450 may 
produce better-aligned output. 


The negn names of, and resulting output for, the Greek 
and s — characters supported by 450 are shown in 
greek(5 


SEE ALSO 


BUGS 


taba(i, onl Ruane re 


Some special characters cannot be correctly printed in 
column 1 because the print head cannot be moved to the 
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left from there. 

If your output contains Greek and/or reverse line-feeds, 
use a friction-feed platen instead of a forms tractor; 
although good enough for drafts, the latter has a 
tendency to slip when reversing direction, distorting 
Greek characters and misaligning the first line of text 
after one or more reverse line-feeds. 


NAME 


ACCEPT (1M) 


accept, reject — allow/prevent LP requests 


SYNOPSIS 


/usr/lib/accept destinations 
/usr/lib/reject { —r[ reason || destinations 


DESCRIPTION 


FILES 


Accept allows Ip P(t) to accept requests for the named 
destinations. estinatton can be either a printer or a 
class of Re Use Ipstat(1) to find the status of 
destinations. 


Reject prevents Ip(1) from accepting requests for the 
named destinations. A destination can be either a 
printer or a class of printers. Use Ipstat(1) to find the 
status of destinations. The following option is useful 
with reject. 


—r{ reason] Associates a reason with preventing [p 
from accepting requests. This reason 
applies to all printers mentioned up to the 
next —r option. Reason is reported by Ip 
when users direct requests to the named 
destinations and by (pstat(1). If the —r 
option is not present or the —r option is 
given without a reason, then a default 
reason will be used. 


/usr/spool/lp/* 


SEE ALSO 


enable(1), lp(1), Ipadmin(1M), Ipsched(1M), Ipstat(1). 
MightyFrame Administrator’s Reference Manual. 
MintF'rame Administrator’s Manual. 


NAME 


ACCT(1M) 


acctdisk, acctdusg, accton, acctwtmp — overview of 
accounting and miscellaneous accounting commands 


SYNOPSIS 


/usr/lib/acct/acctdisk 
/usr/lib/acct/acctdusg [—u file] [—p file | 
/usr/lib/acct/accton | file | 
/usr/lib/acct/acctwtmp "reason” 


DESCRIPTION 


Accounting software is structured as a set of tools 
(consisting of both C programs and shell procedures) that 
can be used to build accounting systems. Acctsh(1M) 
describes the set of shell procedures built on top of the C 
programs. 


Connect time accounting is handled by various programs 
that write records into /etc/utmp/, as described in 
utmp(4). The programs described in acctcon(1M) 
convert this file into session and charging records, which 
are then summarized by acctmerg(1M). 


Process accounting is performed by the CTIX System 
kernel. Upon termination of a process, one record per 
process is written to a file (normally /usr/adm/pacct). 
The programs in acctpre(1M) summarize this data for 
charging purposes; acctems(1M) is used to summarize 
command usage. Current process data may be examined 
using acetcom(1). 


Process accounting and connect time accounting (or any 
accounting records in the format described in acct(4)) 
can be merged and summarized into total accounting 
records by acctmerg (see tacct format in acct(4)). 
Prtacct (see acctsh(1M)) is used to format any or all 
accounting records. 


Acctdisk reads lines that contain user ID, login name, 
and number of disk blocks and converts them to total 
accounting records that can be merged with other 
accounting records. 


Acctdusg reads its standard input (usually from find / 
~print) and computes disk resource consumption 
(including indirect blocks) by login. If —u is given, 
records consisting of those file names for which acctdusg 
charges no one are placed in file (a potential source for 
finding users trying to avoid disk charges). If —p is 
given, file is the name of the password file. This option 
is not needed if the password file is /ete/passwd. (See 
diskusg(1M) for more details.) 


aris 


FILES 


ACCT(1M) 


Accton alone turns process accounting off. If file is 
given, it must be the name of an existing file, to which 
the kernel appends process accounting records (see 
acct(2) and acct(4)). 


Acctwtmp writes a utmp(4) record to its standard 
output. The record contains the current time and a 
string of characters that describe the reason. A record 
type of ACCOUNTING is assigned (see utmp(4)). Reason 
must be a string of 11 or less characters, numbers, $, or 
spaces. For example, the following are suggestions for 
use in reboot and shutdown procedures, respectively: 


acctwtmp uname >> /etc/wtmp 
acctwtmp "file save” >> /etc/wtmp 


/etc/passwd used for login name to user ID 
conversions 
/usr/lib/acct holds all accounting commands listed 


in sub-class 1M of this manual 
/usr/adm/pacct current process accounting file 
/etc/wtmp login/logoff history file 


SEE ALSO 


acctcms(1M), stcteomt). atone acctmerg(1M), 
acctpre(t[M), acctsh(1M), diskusg( 1M), fwtmp(1M), 
runacct(1M), acct(2), acct(4), utmp(4). 

CTIX Programmer s Gutde. 

MightyFrame Administrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 


ACCTCMS (1M) 


NAME 
acctcms - command summary from _per-process 
accounting records 

SYNOPSIS 
/usr /lib/acct/acctcms [options] files 

DESCRIPTION 


Acctems reads one or more files, normally in the form 
described in acct(4). It adds all records for processes 
that executed identically-named commands, sorts them, 
and writes them to the standard output, normally using 
an internal summary format. The options are: 


~a Print output in ASCII rather than in the internal 
summary format. The output includes command 
name, number of times executed, total kcore- 
minutes, total CPU minutes, total real minutes, 
mean size (in K), mean CPU minutes per 
invocation, and “hog factor’’, characters 
transferred, and blocks read and written, as in 
acctcom(1). Output is normally sorted by total 
kcore-minutes. 

-c Sort by total CPU time, rather than total kcore- 


minutes. 

-j Combine all commands invoked only once under 
‘“Seeekother’’, 

—n Sort by number of command invocations. 

-8 Any file names encountered hereafter are already 
in internal summary format. 

—t Process all records as total accounting records. 


The default internal summary format splits each 
field into prime and non-prime time parts. This 
option combines the prime and non-prime time 
parts into a single field that is the total of both, 
and provides upward compatibility with old style 
acctcms internal summary format records. 


The following options may be used only with the —a 
option. 


—p Output a prime-time-only command summary. 


-o Output a non-prime (offshift) time only 
command summary. 


When -p and —o are used together, a combination 
prime and non-prime time report is produced. All the 
output summaries will be total usage except number of 
times executed, CPU minutes, and real minutes which 
will be split into prime and non-prime. 
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A typical sequence for performing daily command 
accounting and for maintaining a running total is: 


acctems file ... >today 

cp total previoustotal 

acctcms -s today previoustotal >total 
acctems —a -s today 


SEE ALSO 


BUGS 


2 


acct(1M), acctcom(1), ateleonN acctmerg(1M), 
acctpre(1M), acctsh(1M), fwtmp(1M),  runacct(1M 
acct(2), acct(4), utmp(4). 

MightyFrame Administrator’s Reference Manual. 
MintFrame Administrator’s Manual. 


Unpredictable output results if —t is used on new style 
internal summary format files, or if it is not used with 
old style internal summary format files. 


NAME 


ACCTCOM(1) 


acctcom — search and print process accounting file(s) 


SYNOPSIS 


acctcom | [options] [file] ].. . 


DESCRIPTION 


Acctcom reads file, the standard’ input, or 
/usr/adm/pacct, in the form described by acct(4) and 
writes selected records to the standard output. Each 
record represents the execution of one process. The 
output shows the COMMAND NAME, USER, 
TTYNAME, START TIME, END TIME, REAL 
SEC), CPU (SEC), MEAN SIZE(K), and optionally, F 
the fork/exec flag: 1 for fork without exec), STAT (the 
system exit status), HOG FACTOR, KCORE MIN, 
CPU FACTOR, CHARS TRNSFD, and BLOCKS 
READ (total blocks read and written). 


The command name is prepended with a # if it was 
executed with super-user privileges. If a process is not 
associated with a known terminal, a ? is printed in the 
TTYNAME field. 


If no files are specified, and if the standard input is 
associated with a terminal or /dev/null (as is the case 
when using & in the shell), /usr/adm/pacct is read; 
otherwise the standard input is read. 


If any file arguments are given, they are read in their 
respective order. Each file is normally read forward, 1.e., 
in chronological order by process completion time. The 
file /usr/adm/pacct is usually the current file to be 
examined; a busy system may need several such files of 
which all but the current file are found in 
/usr/adm/pacct?. The options are: 


—a Show some average statistics about the 
processes selected. The statistics will be 
printed after the output records. 

—b Read backwards, showing latest 
commands first. This option has no effect 
when the standard input is read. 


-f Print the fork/ezec flag and system exit 
status columns in the output. 
~h Instead of mean memory size, show the 


fraction of total available CPU time 
consumed by the process during its 
execution. This “‘hog factor” is computed 
as: 

(total CPU time)/(elapsed time). 


—g group 


—d mm/dd 


—s time 
~e time 
—S time 


—E time 


~n pattern 


-4q 
—o ofile 


-H factor 
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Print columns containing the I/O counts 
in the output. 

Instead of memory size, show total kcore- 
minutes. 

Show mean core size (the default). 

Show CPU factor (user time/(system-time 
+ user-time). 

Show separate system and user CPU 
times. 

Exclude column headings from the output. 
Show only processes belonging to terminal 
/dev/line. 

Show only processes belonging to user 
that may be specified by: a user ID, a 
login name that is then converted to a 
user ID, a # which designates only those 
processes executed with  super-user 
privileges, or ? which designates only 
those processes associated with unknown 
user IDs. 

Show only processes belonging to group. 
The group may be designated by either 
the group ID or group name. 

Any time arguments following this flag 
are assumed to occur on the given month 
mm and the day dd rather than during 
last 24 hours. This is needed for looking 
at old files. 

Select processes existing at or after time, 
given in the format Ar [: min |: sec | | 
Select processes existing at or before 
time . 

Select processes starting at or after time. 
Select processes ending at or before time . 
Using the same time for both —S and —E 
shows the processes that existed at time. 
Show only commands matching pattern 
that may be a regular expression as in 
ed(1) except that + means one or more 
occurrences. 

Do not print any output records, just 
print the average statistics as with the —a 
option. 

Copy selected process records in the input 
data format to oftle; supress standard 
output printing. 

Show only processes that exceed factor, 
where factor is the “hog factor’ as 
explained in option —h above. 
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FILES 
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—O sec Show only processes with CPU system 
time exceeding sec seconds. 

-C sec Show only processes with total CPU time, 
system plus user, exceeding sec seconds. 

-I chars Show only processes transferring more 


characters than chars. 
Listing options together has the effect of a logical and. 


/etc/passwd 
/usr/adm/pacct 
/etc/group 


SEE ALSO 


BUGS 


ps(1), 

acct(IM), acctcms(1M), acctcon(1M), acctmerg(1M), 
acctpre(1M), acctsh(1M), fwtmp(1M), runacct(1M), su(L), 
acct(2), acct(4), utmp(4). 

MightyFrame Administrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 


Acctcom only reports on processes that have terminated; 7 
use ps(1) for active processes. If time exceeds the | 
present time and option —d is not used, then time is 
interpreted as occurring on the previous day. 
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NAME 
acctconl, acctcon2 — connect-time accounting 


SYNOPSIS 
/usr/lib/acct/acctcon1 [options] 
/usr /lib/acct/acctcon2 


DESCRIPTION 

Acctcon! converts a sequence of login/logoff records 
read from its standard input to a sequence of records, 
one per login session. Its input should normally be 
redirected from /ete/wtmp. Its output is ASCII, giving 
device, user ID, login name, prime connect time 
(seconds), non-prime connect time (seconds), session 
starting time (numeric), and starting date and time. The 
options are: 


-p Print input only, showing line name, login 
name, and time (in both numeric and date/time 
formats). 

—t Acctcon! maintains a list of lines on which users 


are logged in. When it reaches the end of its 
input, it emits a session record for each line that 
still appears to be active. It normally assumes 
that its input is a current file, so that it uses the 
current time as the ending time for each session 
still in progress. The —t flag causes it to use, 
instead, the last time found in its input, thus 
assuring reasonable and repeatable numbers for 
non-current files. 

—l file File is created to contain a summary of line 
usage showing line name, number of minutes 
used, percentage of total elapsed time used, 
number of sessions charged, number of logins, 
and number of logoffs. This file helps track line 
usage, identify bad lines, and find software and 
hardware oddities. Hang-up, termination of 
login(1) and termination of the login shell each 
generate logoff records, so that the number of 
logoffs is often three to four times the number 
of sessions. See tntt(1M) and utmp(4). 

-o file File is filled with an overall record for the 
accounting period, giving starting time, ending 
time, number of reboots, and number of date 
changes. 


Acctcon2 expects as input a sequence of login session 
records and converts them into total accounting records 
(see tacct format in acct(4)). 
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EXAMPLES 
These commands are typically used as shown below. 
The file etmp is created only for the use of acctpre(1M) 
commands: 


acctconl —t —] lineuse ~o reboots <wtmp | sort +1n +2 
>ctmp 
acctcon2 <ctmp | acctmerg >ctacct 


FILES 
/etc/wtmp 


SEE ALSO 
acct(1M), acctems(1M), acctcom(1), acctmerg(1M), 
acctpre(1M), acctsh(1M), fwtmp(1M), init(1M), login(1), 
runacct(1M)}, acct(2), acct(4), utmp(4 
MightyFrame Administrator's Reference Manual. 
MiniFrame Administrator’s Manual. 


BUGS 
The line usage report is confused by date changes. Use 
wimpfiz (see fwtmp(1M)) to correct this situation. 
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SEE ALSO 


BUGS 


grep(1), lex(1), malloc, sed(1). 
CTL Programmer's utde, Sule 16. 


Input white space is not preserved on output if fields are 
involved. 

There are no explicit conversions between numbers and 
strings. To force an expression to be treated as a 
number add 0 to it; to force it to be treated as a string 
concatenate the null string (” “) to it. 
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NAME 

banner — make posters 
SYNOPSIS 

banner strings 
DESCRIPTION 


Banner prints its arguments (each up to 10 characters 
Jong) in large letters on the standard output. 


SEE ALSO 
echo(1). 
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NAME 
basename, dirname - deliver portions of path names 


SYNOPSIS 
basename string [ suffix | 
dirname string 


DESCRIPTION 
Basename deletes any prefix ending in / and the suffiz 
(if present in string) from string, and prints the result on 
the standard output. It is normally used inside 
substitution marks ( \ *) within shell procedures. 
Dirname delivers all but the last level of the path name 
in string. 
EXAMPLES 
The following example, invoked with the argument 
/usr/src/emd/cat.c, compiles the named file and 
moves the output to a file named cat in the current 
directory: 
cc $1 
mv a.out ‘basename $1 .c* 
The following example will set the shell variable NAME 
to june /ace) cand: 


NAME= ‘dirname /usr/sre/cmd/cat.c* 


SEE ALSO 
sh(1). 


BUGS 
The basename of / is null and is considered an error. 
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NAME 

be — arbitrary-precision arithmetic language 
SYNOPSIS 

be { -c ] { -I | [ file ... | 
DESCRIPTION 


Be is an interactive processor for a language that 
resembles C but provides unlimited precision arithmetic. 
It takes input from any files given, then reads the 
standard input. The —l argument stands for the name of 
an arbitrary precision math library. The syntax for be 
programs is as follows; L means letter a—z, E means 
expression, S means statement. 


Comments 
are enclosed in /* and */. 


Names 
simple variables: L 
array elements: L | E | 
The words “‘ibase’’, ‘‘obase’’, and ‘‘scale”’ 


Other operands 
arbitrarily long numbers with optional sign and 
decimal point. 


E 
ce E ) 


length ( E ) number of significant decimal digits 
scale (E ) number of digits right of decimal point 
L(E,..,E) 
Operators 
+-* / % aw 
(% is remainder; « is power) 
++ -- (prefix and postfix; apply to names)” 
= =+ =—-_— = =/ =% =a 
Statements 
{ S305 5} 
if(E)S 
while (E)S 


for(E;E;E)S 
nul] statement 
break 

quit 
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Function definitions 


define L (L,..., L ) { 


auto L, ..., L 
S;...8 
return ( E ) 
Functions in —! math library 
s(x sine 
“| cosine 
e(x exponential 
I(x) log 


a(x) arctangent 
j(n,x) Bessel function 


All function arguments are passed by value. 


The value of a statement that is an expression is printed 
unless the main operator is an assignment. Either 
semicolons or new-lines may separate statements. 
Assignment to scale influences the number of digits to 
be retained on arithmetic operations in the manner of 
dc(1). Assignments to ibase or obase set the input and 
output number radix respectively. 


The same letter may be used as an array, a function, and 
a simple variable simultaneously. All variables are 
global to the program. “Auto” variables are pushed 
down during function calls. When using arrays as 
function arguments or defining them as automatic 
variables empty square brackets must follow the array 
name. 


Be is actually a preprocessor for de(1), which it invokes 
automatically, unless the —c (compile only) option is 
present. In this case the de input is sent to the standard 
output instead. 


EXAMPLE 
scale = 20 
define e(x){ 
auto a, b, c, i, s 


a=l1 
b=1 
s=1 


for(i=1; 1==1; i++){ 


FILES 
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a= a*x 
b = b*i 
c = a/b 
if(c == 0) return(s) 
s=stc 


} 
} 
defines a function to compute an approximate value of 
the exponential function and 

for(i=1; i<==10; i++) e(i) 


prints approximate values of the exponential function of 
the first ten integers. 


/usr/lib/lib.b mathematical library 
/usr/bin/de desk calculator proper 


SEE ALSO 

de(1). 

CTIX Programmer’s Guide, Section 12. 
BUGS 

No { | yet. 


For statement must have all three E’s. 
Quit is interpreted when read, not when executed. 
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NAME 
bcheck ~ print out the list of blocks associated with i- 
node(s) 

SYNOPSIS 
/usr/local/bin/bcheck [ -¢ <number> |] <special 
device > 

DESCRIPTION 
Bcheck will print out a list of all 1024-byte blocks 
associated with each i-node for a filesystem on a 


<special device>. If the -§ <number> option is given, F 
the printout is restricted to the i-node <number>. 
EXAMPLES 


beheck /dev/rdsk/c0d0s1 


beheck -i 2 /dev/rdsk/c0d0s3 


SEE ALSO 
ncheck(1M). 
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NAME 

bcopy — interactive block copy 
SYNOPSIS 

/etc/beopy 


DESCRIPTION 
Beopy copies from and to files starting at arbitrary block 
(512-byte) boundaries. 


The following questions are asked: 


to: ue name the file or device to be copied 
to). 

offset: (you provide the starting “to” block 
number). 

from: (you name the file or device to be copied 
from). 

offset: (you provide the starting “from” block 
number). 

count: (you reply with the number of blocks to 
be copied). 


After count is exhausted, the from question is repeated 
(giving you a chance to concatenate blocks at the 
to+offset+count location). If you answer from with a 
carriage return, everything starts over. 


Two consecutive carriage returns terminate beopy. 


SEE ALSO 
cpio(1), dd(1). 
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bdiff - big diff 


SYNOPSIS 


bdiff filel file2 [n] [-s] 


DESCRIPTION 


FILES 


Baiff is used in a manner analogous to diff(1) to find 
which lines must be changed in two files to bring them 
into agreement. Its purpose is to allow processing of files 
which are too large for diff. Bdiff ignores lines common 
to the beginning of both files, splits the remainder of 
each file into n-line segments, and invokes diff upon 
corresponding segments. The value of n is 3500 by 
default. If the optional third argument is given, and it is 
numeric, it is used as the value for n. This is useful in 
those cases in which 3500-line segments are too large for 
diff, causing it to fail. If filet (file2) is —, the standard 
input is read. The optional -s (silent) argument 
specifies that no diagnostics are to be printed by bdiff 
{note, however, that this does not suppress possible 
exclamations by diff. If both optional arguments are 
specified, they must appear in the order indicated above. 


The output of bdiff is exactly that of diff, with line 
numbers adjusted to account for the segmenting of the 
files (that is, to make it look as if the files had been 
processed whole). Note that because of the segmenting 
of the files, bdeff does not necessarily find a smallest 
sufficient set of file differences. 


SEE ALSO 


diff(1). 


DIAGNOSTICS 


Use help(1) for explanations. 
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NAME 

bfs — big file scanner 
SYNOPSIS 

bfs {| ~ ] name 
DESCRIPTION 


The Bfs command is (almost) like ed(1) except that it is 
read-only and processes much larger files. Files can be 
up to 1024K bytes (the maximum possible size) and 32K 
lines, with up to 512 characters, including new-line, per 
line. Bfs is usually more efficient than ed for scanning a 
file, since the file is not copied to a buffer. It is most 
useful for identifying sections of a large file where 
esplit(1) can be used to divide it into more manageable 
pieces for editing. 


Normally, the size of the file being scanned is printed, as 
is the size of any file written with the w command. The 
optional ~— suppresses printing of sizes. Input is 
prompted with * if P and a carriage return are typed as 
in ed. Prompting can be turned off again by inputting 
another P and carriage return. Note that messages are 
given in response to errors if prompting is turned on. 


All address expressions described under ed are supported, 
with the exception of finite range constructions ( {.-\}). 
In addition, regular expressions may be surrounded wit 
two symbols besides / and ?: > indicates downward 
search without wrap-around, and < indicates upward 
search without wrap-around. Since bfs uses a different 
regular expression-matching routine from ed, the regular 
expressions accepted are slightly wider in scope (see 
regemp(3X)). There is a slight difference in mark names: 
only the letters a through z may be used, and all 26 
marks are remembered. 


The e, g, v, k, n, p, q, w, =, ! and null commands 
operate as described under ed, except that the default 
command list for g and v is the null command, not p. 
Commands such as ~——, +++-, +++=, -12, and 
+4p are accepted. Note that 1,10p and 1,10 will both 
print the first ten lines. The f command only prints the 
name of the file being scanned; there is no remembered 
file name. The w command is independent of output 


diversion, truncation, or crunching (see the 
xo, xt and xe commands, _ below). The following 
additional commands are available: 

xf file 


Further commands are taken from the named 
file. When an end-of-file is reached, an 
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interrupt signal is received or an error occurs, 
reading resumes with the file containing the 
xf. The Xf commands may be nested to a 
depth of 10. 


xn List the marks currently in use (marks are set 
by the k commnad). 

xo [ file | 
Further output from the p and_ null 
commands is diverted to the named file, 
which, if necessary, is created mode 666. If 
file is missing, output is diverted to the 
standard output. Note that each diversion 
causes truncation or creation of the file. 

: label 


Gigs 


This positions a label in a command file. 
The label is terminated by new-line, and 
blanks between the : and the start of the 
label are ignored. This command may also 
be used to insert comments into a command 
file, since labels need not be referenced. 


)xb/regular ezpression/label 
A jump (either upward or downward) is made 
to label if the command succeeds. It fails 
under any of the following conditions: 
1. Either address is not between 1 
and $. 
2. The second address is less than 
the first. 
3. The regular expression does not 
match at least one line in the 
specified range, including the first 
and last lines. 


On success, is set to the line matched and a 
jump is made to label. This command is the 
only one that does not issue an error message 
on bad addresses, so it may be used to test 
whether addresses are bad before other 
commands are executed. Note that the 
command 


xb/*/ label 


is an unconditional jump. 

The xb command is allowed only if it is read 
from someplace other than a terminal. If it is 
read from a pipe only a downward jump is 
possible. 
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xt number 
Output from the p and null commands is 
truncated to at most number characters. The 
initial number is 255. 


xv digit] { spaces] [ value] 

The variable name is the specified digit 
following the xv. The commands xv5100 or 
xv5 100 both assign the value 100 to the 
variable 5. The command Xv61,100p 
assigns the value 1,100p to the variable 6. 
To reference a variable, put a % in front of 
the variable name. For example, using the 
above assignments for variables 5 and 8: 


1,%5p 
1,%5 
%6 


will all print the first 100 lines. 


6/%5/p 


would globally search for the characters 100 
and print each line containing a match. To 
escape the special meaning of %, a \ must 
precede it. 


g/”.*\%lcds}/p 

could be used to match and list lines 
containing printf of characters, decimal 
integers, or strings. 

Another feature of the xv command is that 
the first line of output from a CTIX command 
can be stored into a variable. The only 
requirement is that the first character of 
value be an !. For example: 


-w junk 

xv5!cat junk 

!rm junk 

echo "%5" 
xv6!expr %6 + 1 


would put the current line into variable 5, 
print it, and increment the variable 6 by one. 
To escape the special meaning of ! as the first 
character of value, precede it with a \. 


SEE ALSO 
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xv7\!date 
stores the value !date into variable 7. 


xbs label 
xbn label 


These two commands will test the last saved 
return code from the execution of a CTIX 
command (!command) or nonzero value, 
respectively, to the specified label. The two 
examples below both search for the next five 
lines containing the string size. 


xv55 
1 
/size/ 
xv5lexpr %5 — 1 
lif 0%5 != 0 exit 2 
xbn | 
xv45 
/site/ 

size 
xv4lexpr %4 — 1 


lif 0%4 = 0 exit 2 
xbz | 


xe [switch] 


If switch is 1, output from the p and null 
commands is crunched; if switch is 0 it is 
not. Without an argument, xe _ reverses 
switch. Initially switch is set for no 
crunching. Crunched output has strings of 
tabs and blanks reduced to one blank and 
blank lines suppressed. 


esplit(1), ed(1), regemp(3X). 
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DIAGNOSTICS 
? for errors in commands, if prompting is turned off. 


Self-explanatory error messages when prompting is on. 


NAME 
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bre, beheckre, rc, powerfail, drvload -— system 
initialization shell scripts 


SYNOPSIS 


/ete/bre 
/ete/bcheckre 
/ete/re 
/etc/powerfail 
/ete/drvload 


DESCRIPTION 


The bre, beheckre, rc, drvload, and powerfail shell 
procedures are executed via entries in /etc/inittab by 
init(IM). Execpt for powerfail, they are run when the 
system is changed out of SINGLE USER mode. Powerfail 
is executed whenever a system power failure is detected. 


The bre procedure clears the mounted file system table, 
/etc/mnttab (see mnittab(4)). 


The bcheckre procedure performs all the necessary 
consistency checks to prepare the system to change into 
multi-user mode. It actually contains two procedures: 
an interactive procedure that runs feck(1M) and sets the 
time; and a noninteractive procedure that only checks 
the file system. The administrator chooses the 
interactive or noninteractive procedure by modifying the 
line in bcheckre that sets the variable CONSOLE, 
PRESENT for _ interactive, ABSENT to 
noninteractive. If the ABSENT procedure fails because 
of file system problems or because it was interrupted 
from the controlling terminal, it switches the system to 
state 6, which is normally CTIX Administrator Mode. 
On a MightyFrame system bcheckre also sets the date to 
the date currently in the real-time clock. 


The re procedure starts all system daemons before the 
terminal lines are enabled for multi-user mode. In 
addition, file systems are mounted and accounting, error 
logging, system activity logging, and printer spooling (if 
the /p(1) system is in ase) are activated in this 
procedure. 


The powerfatl procedure is invoked when the system 
detects a power failure condition. It calls halt(1M) to 
bring down the system gracefully. 


The drvload procedure causes any desired device drivers 
and swap areas to be loaded into the system. The 
system namelist is rebuilt from /unix prior to loading 


es 


BRC(1IM) 


any drivers. This procedure uses hinv(1M) to determine 
what hardware exists and then loads the appropriate 
drivers. 


These shell procedures, in particular re may be used for 
several run-level states. The who(1) command may be 
used to get the run-level information. 


FILES 
/unix 
/etc/log/confile 
SEE ALSO 


conlocate(1M), date(1), fsck(1M), halt(1), hinv(1M), 
init(1M), shutdown(1M), who(1), inittab(4), mnttab(4). 
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NAME 

cal — print calendar 
SYNOPSIS 

eal [{ [ month ] year ] 
DESCRIPTION 


Cal prints a calendar for the specified year. If a month 
is also specified, a calendar just for that month is 
printed. If neither is specified, a calendar for the present 
month is printed. Year can be between 1 and 9999. 
The month is a number between 1 and 12. The calendar 
produced is that for England and her colonies. 


Try September 1752. 


BUGS 
The year is always considered to start in January even 
though this is historically naive. 
Beware that ‘“‘cal 83” refers to the early Christian era, 
not the 20th century. 
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NAME 
calendar — reminder service 

SYNOPSIS 
calendar | - | 

DESCRIPTION 
Calendar consults the file calendar in the current 
directory and prints out lines that contain today’s or 
tomorrow’s date anywhere in the line. Most reasonable 
month-day dates such as ‘“‘Aug. 24,” “‘august 24,” 
“9 /24,”? etc., are recognized, but not “24 August” or 
“94/8”. On weekends “tomorrow” extends through 
Monday. 
When an argument is present, calendar does its job for 
every user who has a file calendar in the login directory 
and sends them any positive results by matl(1). 
Normally this is done daily by facilities in the CTIX 
operating system. 

FILES 
/usr/lib/calprog to figure out today’s and 

tomorrow’s dates 

/etc/passwd 
/tmp/cal* 

SEE ALSO 
mail(1). 

BUGS 


Your calendar must be public information for you to get 
reminder service. 

Calendar’s extended idea of ‘“‘tomorrow”’’ does not 
account for holidays. 


CAT(1) 


NAME 

cat — concatenate and print files 
SYNOPSIS 

cat [| —u ] [ —-s ] [ —v [-t] [-e] ] file ... 
DESCRIPTION 


Cat reads each file in sequence and writes it on the 
standard output. Thus: 


cat file 
prints the file, and: a 
cat filel file2 >file3 


concatenates the first two files and places the result on 
the third. 


If no input file is given, or if the argument — is 
encountered, cat reads from the standard input file. 
Output is buffered unless the —u option is specified. 
The —s option makes cat silent about non-existent files. 


The —v option causes non-printing characters (with the 
exception of tabs, new-lines and form-feeds) to be 

rinted visibly. Control characters are printed “X 
(controls) the DEL character (octal 0177) is printed *?. 
Non-ASCII characters (with the high bit set) are printed 
as M-z, where z is the character specified by the seven 
low order bits. | 


When used with the —v option, —t causes tabs to be | 
printed as “I’s, and —e causes a $ character to be printed | 
at the end of each line (prior to the new-line). The —t 
and —e options are ignored if the ~—v option is not 
specified. 
WARNING 
Command formats such as 
cat filel file2 >filel 
will cause the original data in file1 to be lost; therefore, 
take care when using shell special characters. 
SEE ALSO 
cp(1), pg(1), pr(1). 


NAME 


CATMAN(1) 


catman — create the cat files for the manual 


SYNOPSIS 


/etc/catman [| —p | | —n | [ —w ] [ sections |] 


DESCRIPTION 


FILES 


Catman creates the preformatted versions of the on-line 
manual from the nroff input files. Each manual page is 
examined and those whose preformatted versions are 
missing or out of date are recreated. If any changes have 
been made, catman will recreate the /usr/lib/whatis 
database. 


If there is one parameter not starting with a —, it is 
taken to be a list of manual sections to look in. For 
example 


catman 123 


will cause the updating to happen only to manual 
sections 1, 2, and 3. 


Options: 

-n prevents creation of /usr/lib/whatis. 

-p prints what would be done instead of doing it. 
—w causes only the /usr/lib/whatis database to be 


created. No manual reformatting is done. 


/usr/man/u_man/man{(1-8] 
directories for source files 


/usr/man/cat?/*.* — preformatted manual pages 
/usr/lib/makewhatis commands to make _ whatis 
database 
SEE ALSO 
man(1). 
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NAME 


CB(1) 


cb — © program beautifier 


SYNOPSIS 


cb [ -s ] [| -j ] [ —] leng ] | file ... ] 


DESCRIPTION 


Cb reads C programs either from its arguments or from 
the standard input and writes them on the standard 
output with spacing and indentation that displays the 
structure of the code. Under default options, cb 
preserves all user new-lines. Under the —-s flag cb 
canonicalizes the code to the style of Kernighan and 
Ritchie in The C Programming Language. The —j flag 
causes split lines to be put back together. The —1 flag 
causes cb to split lines that are longer than /eng. 


SEE ALSO 


BUGS 


ec(1). 
The C Programming Language by B. W. Kernighan and 
D. M. Ritchie. 


Punctuation that is hidden in preprocessor statements 
will cause indentation errors. 


NAME 


cc(1) 


cc — C compiler 


SYNOPSIS 


ce [ option | ... file ... 


DESCRIPTION 


5/86 


Ce is the CTIX Portable C compiler. It accepts several 
types of arguments: 


Arguments whose names end with .c are taken to be C 
source programs. They are compiled, and each object 
program is left on the file whose name is that of the 
source with .o substituted for .c. The .o file is normally 
deleted, however, if a single C program is compiled and 
loaded all at one go. 


In the same way, arguments whose names end with .s 
are taken to be assembly source programs and are 
assembled, producing a .o file. 


The following options are interpreted by cc. See Id(1) 
for link editor options and cpp(1) for more preprocessor 
options. 


-# Display without execution each command that 
ce would generate. 


-c Suppress the link edit phase of the compilation 
and force an object file to be produced even if 
only one source file is compiled. 


—p Arrange for the compiler to produce code that 
counts the number of times each routine is 
called; also, if link editing takes place, replace 
the standard startoff routine by one that 
automatically calls monttor(3C) at the start and 
arranges to write out a mon.out file at normal 
termination of execution of the object program. 
An execution profile can then be generated by 
use of prof(1). 


-g Cause the compiler to generate additional 
information needed for the use of sdb(1). 
-O Invoke an object-code optimizer. 


-S Compile the named C programs and leave the 
assembler-language output on corresponding 
files suffixed .s. 


-E Run only cpp(1) on the named C programs and 
send the result to the standard output. 
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-P Run only cpp(1) on the named C programs and 
leave the result on corresponding files suffixed 
a. 


~68020 Generate code for the mc68020 processor. 


—68881 Generate code for the mc68881 floating-point 
coprocessor. 


—68010 Generate code for the mc68010 processor. 
—68000 Generate code for the mc68000 processor. 


—v Verbose. Print pass names as they are 
performed. 
-T Truncate variable names to eight characters. 


Tell the loader to match eight character names 
(same as —G in the loader). 


—w Tell the linker (/d) not to print warnings about 
symbols that partially matched. 


The C compiler uses one of three code generators for the 
68010, 68020, and 68020/68881. You can select one of 
these by two mechanisms. The first is to specify the 
number on the command line. The second is to use the 
CENVIRON shell variable. 


The CENVIRON variable has the following syntax: 
CPU=xxxxx , FPU=yyyyy 


where OPU indicates the central processor to generate 
for and FPU indicates the style of floating-point math to 
use. zazzrx may be 68010 or 68020, and yyyyy may be 
68881 or SOFTWARE. The FPU parameter may be 
omitted; the default is SOFTWARE. The CENVIRON 
variable should always be set to the appropriate values 
in the .profile or .eshre files or in the makefile. 


The C compiler interprets two shell variables which, 
along with the CENVIRON variable, allow cross- 
compilation for any CTIX machine: 


LIBROOT This variable is a path which is 
prepended to normal library names 
when searching for a library. See also 
(d(1). 

INCROOT This variable is a path which is 
prepended to the /usr/include and 
/usr/include/sys directories during 
include file searches. See also cpp(1). 


The following options are useful only on systems where 
work is being done on the C compiler. CTIX normally 
comes with only one version of the compiler, and that 
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version works in a single pass. The options below 
provide for alternative versions of the compiler, including 
two-pass versions. 


-—Bstring 
Construct pathnames for substitute preprocessor, 
compiler, assembler and link editor passes by 
concatenating string with the suffixes cpp 
(pre pce): c0, (or ccom (compiler first 
pass ccom20, ccom20.81, or comp (see under 
FILES below), cl (compiler second pass), ¢2 
optimizer) (or optim), as (assembler), and Id 
link editor). If string is empty it is taken to be 
/lib/o. 

~t{p012al] 
Find only the designated preprocessor, compiler, 
assembler and link editor passes in the files 
whose names are constructed by a —B option. 
In the absence of a —B option, the string is 
taken to be /lib/n. The value -t ”” is 
equivalent to —tp012. 


~We,arg1|,arg2... 
Hand off the argument|s| argi to pass c where c 
is one of [p012al] indicating preprocessor, 
compiler first pass, compiler second pass, 
optimizer, assembler, or link editor, respectively. 


~d This option is no longer allowed because of a 
conflict of meaning. The —W option must be 
used to specify precisely its destination. To 
indicate the ~—d option for the link editor, use 
—WI1,-d. 


Other arguments are taken to be either link editor 
option arguments, C preprocessor option arguments, or 
C-compatible object programs, typically produced by an 
earlier cc run, or perhaps libraries of O-compatible 
routines. These programs, together with the results of 
any compilations specified, are linked (in the order 
given) to produce an executable program with the name 
a.out. 


Note that modules appear to /d in the same order they 
(or their source code versions) appear to cc. Thus a 
library or object file should appear in the ec argument 
list after any module that refers to it. 


The C language standard was extended to include 
arbitrary length variable names. The option pair 
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“_Wp,-T —W0,-XT” will cause the current compiler 
to behave the same as previous compilers with respect to 
the length of variable names. 


FILES 
file.c input file 
file.o object file 
a.out linked output 
/tmp/ctm* temporary 
/lib/cpp C preprocessor epp(1) 
/lib/ecom compiler 
/lib/ccom20 68020 compiler 
/lib/ccom20.81 68020/68881 compiler 
/lib/optim optional optimizer 
/bin/as assembler, as(1) 
/bin/ld link editor, (d(1) 
/lib/crt0.o runtime startoff 
/lib/mert0.o profiling startoff 
/lib/libc.a standard C library, see section (3) 
/lib/libp/lib/*.a profiled versions of libraries 
Pr aal (1), as(1), 1d(1), prof(1) (3C) 
adb(1), cpp(1), as(1), ld(1), prof(1), monitor(3C). 
spel), aelt), Guide, Section 12. 
The C Programming Language by B. W. Kernighan and 
D. M. Ritchie. 
NOTES 
By default, the return value from a C program is 
completely random. The only two guaranteed ways to 
return a specific value are to explicitly call eztt(2) or to 
leave the function main( ) with a “return ezpression;” 
construct. 
DIAGNOSTICS 


The diagnostics produced by C itself are intended to be 
self-explanatory. Occasional messages may be produced 
by the assembler or the link editor. 


NAME 
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ed — change working directory 


SYNOPSIS 


ed | directory | 


DESCRIPTION 


If directory is not specified, the value of shell parameter 
$HOME is used as the new working directory. If 
directory specifies a complete path starting with /,., .., 
directory becomes the new working directory. If neither 
case applies, cd tries to find the designated directory 
relative to one of the paths specified by the $CDPATH 
shell variable. $CDPATH has the same syntax as, and 
similar semantics to, the $PATH shell variable. Cd 
must have execute (search) permission in directory. 


Because a new process is created to execute each 
command, cd would be ineffective if it were written as a 
normal command; therefore, it is recognized and is 
internal to the shell. 


SEE ALSO 


pwd(1), sh(1), chdir(2). 
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NAME 

cde — change the delta commentary of an SCCS delta 
SYNOPSIS 

ede —rSID {[—m{mrlist]] (—y[comment]] files 
DESCRIPTION 


Cde changes the delta commentary, for the SID specified 
by the —r keyletter, of each named SCCS file. 


Delta commentary is defined to be the Modification 
Request (MR) and comment information normally 
specified via the delta(1) command (—m and -y 
keyletters). 


If a directory is named, cde behaves as though each file 
in the directory were specified as a named file, except 
that non-SCCS files (last component of the path name 
does not begin with s.) and unreadable files are silently 
ignored. If a name of — is given, the standard input is 
read (see WARNINGS); each line of the standard input is 
taken to be the name of an SCCS file to be processed. 


Arguments to ede, which may appear in any order, 
consist of keyletter arguments and file names. 


All the described keyletter arguments apply 
independently to each named file: 


—rsID Used to specify the SCCS 
IDentification (SID) string of a 
delta for which the delta 
commentary is to be changed. 


—m([mrlist] If the SCCS file has the v flag set 
(see admin(1)) then a list of MR 
numbers to be added and/or 
deleted in the delta commentary 
of the SID specified by the -r 
keyletter may be supplied. A null 
MR list has no effect. 


MR entries are added to the list 
of MRs in the same manner as 
that of delta(1). In order to 
delete an MR, precede the MR 
number with the character ! (see 
EXAMPLES). If the MR to be 
deleted is currently in the list of 
MRs, it is removed and changed 
into a “comment” line. A list of 
all deleted MRs is placed in the 
comment section of the delta 
commentary and preceded by a 


=f 


—y[comment] 
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comment line stating that they 
were deleted. 


If -—m is not used and _ the 
standard input is a terminal, the 
prompt MRs? is issued on the 
standard output before the 
standard input is read; if the 
standard input is not a terminal, 
no prompt is issued. The MRs? 
prompt always precedes’ the 
comments? prompt (see ~y 
keyletter). 


MRs in a list are separated by 
blanks and/or tab characters. An 
unescaped new-line character 
terminates the MR list. 


Note that if the v flag has a value 
(see admin(1)), it is taken to be 
the name of a program (or shell 
procedure) which validates the 
correctness of the MR numbers. 
If a non-zero exit status is 
returned from the MR number 
validation program, cdc 
terminates and the delta 
commentary remains unchanged. 


Arbitrary text used to replace the 
comment(s) already existing for 
the delta specified by the -r 
keyletter. The previous 
comments are kept and preceded 
by a comment line stating that 
they were changed. A_ null 
comment has no effect. 


If -y is not specified and the 
standard input is a terminal, the 
prompt comments? is issued on 
the standard output before the 
standard input is read; if the 
standard input is not a terminal, 
no prompt. is_ issued. An 
unescaped new-line character 
terminates the comment text. 


The exact permissions necessary to modify the 
SCCS file are documented in the Source Code 
Control System User’s Guide. Simply stated, they 
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are either (1) if you made the delta, you can 
change its delta commentary; or (2) if you own the 
file and directory you can modify the delta 
commentary. 


EXAMPLES 


ede -ri.6 —m"bl78-12345 !bl77-54321 b179-00001” 
~ytrouble s.file 


adds bl78-12345 and bl79-00001 to the MR list, removes 
bl177-54321 from the MR list, and adds the comment 
trouble to delta 1.6 of s.file. 

cde —-r1.6 s.file 

MRs? !b177-54321 b178-12345 b179-00001 

comments? trouble 


does the same thing. 


WARNINGS 


If SCCS file names are supplied to the ede command via 
the standard input (— on the command line), then the 
—m and —y keyletters must also be used. 


FILES 
x-file see delta(1 
z-file see delta(1 
SEE ALSO 
admin(1), delta(1), get(1), help(1), prs(1), sccsfile(4). 
CTIX Programmer’s Guide, Section 9. 
DIAGNOSTICS 


Use help(1) for explanations. 


NAME 


CFLOW(1) 


cflow — generate C flowgraph 


SYNOPSIS 


cflow {-r] [—ix] [-i_] [-dnum] files 


DESCRIPTION 


Cflow analyzes a collection of C, YACC, LEX, assembler, 
and object files and attempts to build a graph charting 
the external references. Files suffixed in .y, .l, .c, and .i 
are YACC’d, LEX’d, and C-preprocessed (bypassed for .i 
files) as appropriate and then run through the first pass 
of lint(1). (The —-I, —D, and —U options of the C- 
preprocessor are also understood.) Files suffixed with .s 
are assembled and information is extracted (as in .o files) 
from the symbol table. The output of all this non-trivia 
processing is collected and turned into a graph of 
external references which is displayed upon the standard 
output. 


Each line of output begins with a reference (i.e., line) 
number, followed by a suitable number of tabs indicating 
the level. Then the name of the global (normally only a 
function not defined as an external or beginning with an 
underscore; see below for the —i inclusion option) a colon 
and its definition. For information extracted from C 
source, the definition consists of an abstract type 
declaration (e.g., char *), and, delimited by angle 
brackets, the name of the source file and the line number 
where the definition was found. Definitions extracted 
from object files indicate the file name and location 
counter under which the symbol appeared (e.g., tezt). 
Leading underscores in O-style external names are 
deleted. 


Once a definition of a name has been printed, subsequent 
references to that name contain only the reference 
number of the line where the definition may be found. 
For undefined references, only < > is printed. 


As an example, given the following in file.c: 
int 1; 


main() 


oo 
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f() 
i = h(); 


the command 
cflow — ix file.c 
produces the output 


1 main: int(), <file.c 4> 

2 f: int(), <file.c 11> 

3 h: <> 

4 i: int, <file.c 1> 
5 g.<> 


When the nesting level becomes too deep, the —e option 
of pr(1) can be used to compress the tab expansion to 
something less than every eight spaces. 


The following options are interpreted by cflow: 


-r Reverse the ‘‘caller:callee’” relationship 
producing an inverted listing showing the callers 
of each function. The listing is also sorted in 
lexicographical order by callee. 


—ix Include external and static data symbols. The 
default is to include only functions in the 
flowgraph. 

-i_ Include names that begin with an underscore. 


The default is to exclude these functions (and 
data if ~tz is used). 

—dnum The num decimal integer indicates the depth at 
which the flowgraph is cut off. By default this 
is a very large number. Attempts to set the 
cutoff depth to a nonpositive integer will be 
met with contempt. 

DIAGNOSTICS 

Complains about bad options. Complains about multiple 

definitions and only believes the first. Other messages 

may come from the various programs used (e.g., the C- 

preprocessor). 

SEE ALSO 
as(1), cc(1), cpp(1), lex(1), lint(1), nm(1), pr(1), yace(1). 


CFLOW(1) 


BUGS 
Files produced by ler(1) and yacc(1) cause the reordering 
of line number declarations which can confuse cflow. To 
get proper results, feed cflow the yacc or lez input. 


NAME 


CHMOD (1) 


chmod — change mode 


SYNOPSIS 


chmod mode files 


DESCRIPTION 


The permissions of the named files are changed 
according to mode, which may be absolute or symbolic. 
An absolute mode is an octal number constructed from 
the OR of the following modes: 


4000 set user ID on execution 

2000 set group ID on execution 

1000 sticky bit, see chmod(2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by 
owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by 
others 


A symbolic mode has the form: 
[ who | op permission | op permission | 


The who part is a combination of the letters u (for user’s 
permissions), g (group) and o (other). The letter a 
stands for ugo, the default if who is omitted. 


Op can be + to add permission to the file’s mode, ~ to 
take away permtsston, or = to assign permission 
absolutely (all other bits will be reset). 


Permission is any combination of the letters r (read), w 
(write), x (execute), s (set owner or group ID) and t (save 
text, or sticky); u, g, or o indicate that permission is to 
be taken from the current mode. Omitting permission is 
only useful with = to take away all permissions. 


Multiple symbolic modes separated by commas may be 
given. Operations are performed in the order specified. 
The letter s is only useful with u or g and t only works 
with u. 


Only the owner of a file (or the super-user) may change 
its mode. Only the super-user may set the sticky bit. In 
order to set the group ID, the group of the file must 
correspond to your current group ID. 
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EXAMPLES 
The first example denies write permission to others, the 
second makes a file executable: 


chmod o-w file 
chmod +x file 


SEE ALSO 
Is(1), chmod(2). 
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NAME 
chown, chgrp — change owner or group 


SYNOPSIS 
chown owner file ... 
chgrp group file ... 
DESCRIPTION 
Chown changes the owner of the files to owner. The 
owner may be either a decimal user ID or a login name 
found in the password file. 
Chgrp changes the group ID of the files to group. The 
group may be either a decimal group ID or a group name 
found in the group file. 
If either command is invoked by other than the super- 
user, the set-user-ID and set-group-ID bits of the file 
mode, 04000 and 02000, respectively, will be cleared. 
FILES 
/etc/passwd 
/etc/group 
SEE ALSO 
chown(2), group(4), passwd(4). 
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NAME 

chroot -- change root directory for a command 
SYNOPSIS 

/ete/chroot newroot command 
DESCRIPTION 


The given command is executed relative to the new root. 
The meaning of any initial slashes (/) in path names is 
changed for a command and any of its children to 
newroot. Furthermore, the initial working directory is 
newroot. 


Notice that: 
chroot newroot command >x 
will create the file x relative to the original root, not the 
new one. 
This command is restricted to the super-user. 


The new root path name is always relative to the current 
root: even if a chroot is currently in effect, the newroot 
argument is relative to the current root of the running 
process. 


SEE ALSO 
chdir(2). 


BUGS 
One should exercise extreme caution when referencing 
special files in the new root file system. 


ar 
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NAME 
clear — clear terminal screen 


SYNOPSIS 
clear 

DESCRIPTION 
Clear prints the string that clears your terminal’s screen. 
The program obtains this string from the termcap(5) 
database, using the TERM environment variable to 
determine the type of terminal. 


FILES 
/etc/termcap _ terminal capability data base 


SEE ALSO 
sh(1), termcap(5). 


NAME 


CLRI(1M) 


clri — clear i-node 


SYNOPSIS 


/ete/clri file-system i-number ... 


DESCRIPTION 


SEE ALS 


BUGS 


Clri writes zeros on the 64 bytes occupied by the i-node 
numbered t-number. File-system must be a special file 
name referring to a device containing a file system. 
After elrt is executed, any blocks in the affected file will 
show up as “missing” i in an fsck(1M) of the file-system. 
This command should only be used in emergencies and 
extreme care should be exercised. 


Read and write permission is required on the specified 
file-system device. The i-node becomes allocatable. 


The primary purpose of this routine is to remove a file 
which for some reason appears in no directory. If it is 
used to zap an i-node which does appear in a directory, 
care should be taken to track down the entry and 
remove it. Otherwise, when the i-node is reallocated to 
some new file, the old entry will still point to that file. 
At that point removing the old entry will destroy the 
new file. The new entry will again point to an 
unallocated i-node, so the whole cycle is likely to be 
ee again and again. 


feck( IM), fsdb(1M), ncheck(1M), fs(4). 


If the file is open, clri is likely to be ineffective. 
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NAME 
cmp — compare two files 
SYNOPSIS 
emp [ -1] ( —s | filel file2 
DESCRIPTION 
The two files are compared. (If file1 is —, the standard 
input is used.) Under default options, emp makes no 
comment if the files are the same; if they differ, it 
announces the byte and line number at which the 
difference occurred. If one file is an initial subsequence 
of the other, that fact is noted. 
Options: 
-l ‘Print the byte number icecimal) and the differing 
bytes (octal) for each difference. 
-s Print nothing for differing files; return codes only. 
SEE ALSO 
comm(1), diff(1). 
DIAGNOSTICS 


Exit code 0 is returned for identical files, 1 for different 
files, and 2 for an inaccessible or missing argument. 


NAME 


COL(1) 


col — filter reverse line-feeds 


SYNOPSIS 


col {| —bfpx | 


DESCRIPTION 


Col reads from the standard input and writes onto the 
standard output. It performs the line overlays implied 
by reverse line feeds (ASCII code ESC-7), and by forward 
and reverse half-line feeds (ESC-9 and ESC-8). Col is 
particularly useful for filtering-multicolumn output made 
with the .rt command of nroff and output resulting from 
use of the tb/(1) preprocessor. 


If the —b option is given, col assumes that the output 
device in use is not capable of backspacing. In this case, 
if two or more characters are to appear in the same 
place, only the last one read will be output. 


Although col accepts half-line motions in its input, it 
normally does not emit them on output. Instead, text 
that would appear between lines is moved to the next 
lower full-line boundary. This treatment can be 
suppressed by the —f (fine) option; in this case, the 
output from col may contain forward half-line feeds 
(ESC-9), but will still never contain either kind of 
reverse line motion. 


Unless the —x option is given, col will convert white 
space to tabs on output wherever possible to shorten 
printing time. 

The ASCII control characters SO (\016) and SI (\017) are 
assumed by col to start and end text in an alternate 
character set. The character set to which each input 
character belongs is remembered, and on output SI and 
SO characters are generated as appropriate to ensure 
that each character is printed in the correct character 
set. 


On input, the only control characters accepted are space, 
backspace, tab, return, new-line, SI, SO, VT (\013), and 
ESC followed by 7, 8, or 9. The VT character is an 
alternate form of full reverse line-feed, included for 
compatibility with some earlier programs of this type. 
All other non-printing characters are ignored. 


Normally, col will ignore any unknown to it escape 
sequences found in its input; the —p option may be used 
to cause col to output these sequences as regular 
characters, subject to overprinting from reverse line 
motions. The use of this option is highly discouraged 
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unless the user is fully aware of the textual position of 
the escape sequences. 


SEE ALSO 


NOTES 


BUGS 


nroff(1), tbi(1). 


The input format accepted by col matches the output 
produced by nroff with either the —~T37 or —TlIp 
options. Use ~T37 fend the ~f option of col) if the 
ultimate disposition of the output of col will be a device 
that can interpret half-line motions, and —Tlp otherwise. 


Cannot back up more than 128 lines. 

Allows at most 800 characters, including backspaces, on 
a line. 

Local vertical motions that would result in backing up 
over the first line of the document are ignored. As a 
result, the first line must not have any superscripts. 
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NAME 

comb ~ combine SCCS deltas 
SYNOPSIS 

comb [{-—o] (-s] {—psid| [—clist] files 
DESCRIPTION 


Comb generates a shell procedure (see sh(1)) which, 
when run, will reconstruct the given SCCS files. The 
reconstructed files will, hopefully, be smaller than the 
origina] files. The arguments may be specified in any 
order, but all keyletter arguments apply to all named 
SCCS files. If a directory is named, comb behaves as 
though each file in the directory were specified as a 
named file, except that non-SCCS files (last component 
of the path name does not begin with s.) and unreadable 
files are silently ignored. If a name of — is given, the 
standard input is read; each line of the input is taken to 
be the name of an SCCS file to be processed; non-SCCS 
files and unreadable files are silently ignored. 


The generated shell procedure is written on the standard 
output. 


The keyletter arguments are as follows. Each is 
explained as though only one named file is to be 
processed, but the effects of any keyletter argument 
apply independently to each named file. 


-pSID The SCCS IDentification string (SID) of the 
oldest delta to be preserved. All older deltas 
are discarded in the reconstructed file. 


—elist A list (see get(1) for the syntax of a list) of 
deltas to be preserved. All other deltas are 
discarded. 


-o For each get -—e generated, this argument 
causes the reconstructed file to be accessed at 
the release of the delta to be created, otherwise 
the reconstructed file would be accessed at the 
most recent ancestor. Use of the —o keyletter 
may decrease the size of the reconstructed SCCS 
file. It may also alter the shape of the delta 
tree of the original file. 


-8 This argument causes comb to generate a shell 
procedure which, when run, will produce a 
report giving, for each file: the file name, size 
(in blocks) after combining, original size (also in 
blocks), and percentage change computed by: 

100 * (original — combined) / original 
It is recommended that before any SCCS files 
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are actually combined, one should use this 
option to determine exactly how much space is 
saved by the combining process. 


If no keyletter arguments are specified, comb will 
preserve only leaf deltas and the minimal number of 
ancestors needed to preserve the tree. 


FILES 
s.COMB The name of the reconstructed SCCS file. 
comb????? Temporary. 

SEE ALSO 
admin(1), delta{1), get(1), help(1), prs(1), —sh(1), 
sccsfile(4). 
CTIX Programmer’s Gutde, Section 9. 

DIAGNOSTICS 
Use help(1) for explanations. 

BUGS 


Comb may rearrange the shape of the tree of deltas. It 
may not save any space; in fact, it is possible for the 
reconstructed file to actually be larger than the original. 
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NAME 

comm — select or reject lines common to two sorted files 
SYNOPSIS 

comm | — [ 123 | | filel file2 
DESCRIPTION 


Comm reads file! and file2, which should be ordered in 
ASCII collating sequence (see sort(t) and produces a 
three-column output: lines only in ftle1; lines only in 
file2; and lines in both files. The file name — means the 
standard input. 


Flags 1, 2, or 3 suppress printing of the corresponding 
column. Thus comm —12 prints only the lines common 
to the two files; comm —23 prints only lines in the first 
file but not in the second; comm —123 is a no-op. 


SEE ALSO 


emp(1), diff(1), sort(1), uniq(1). 


oo 
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NAME 
config — configure a CTIX system 

SYNOPSIS 
/ete/config { —t | { —I file | [ ~e file ] { -m 
file | dfile 

DESCRIPTION 


Config is a program that takes a description of a CTIX 
system, generates a configuration table file, and 
generates a hardware interface file. The configuration 
table file is a C program defining the configuration 
tables for the various devices on the system. The 
hardware interface file provides information regarding 
the interface between the hardware and device handlers. 


The ~1l option specifies the name of the hardware 
interface file; low.s is the default. 


The —c option specifies the name of the configuration 
table file; conf.c is the default name. 


The —m option specifies the name of the file that 
contains all the information regarding supported devices; 
/etc/master is the default name. This file is supplied 
with the CTIX system and should not be modified unless 
the user fully understands its construction. 


The —t option requests a short table of major device 
numbers for character and block type devices. This can 
facilitate the creation of special files. 


The user must supply a dftle; it must contain device 
information for the user’s system. This file is divided 
into two parts. The first part contains physical device 
specifications. The second part contains system- 
dependent information. Any line with an asterisk (*) in 
column 1 is a comment. Several sample dfile files are 
provided in the /usr/sys/ef directory: dfile, dfilecl, 
and dfilevme. 


First Part of dfile 
Each Jine contains one field: 


devname 


where devname is the name of the device (as it appears 
in the /ete/master device table). 


Second Part of dfile 
The second part contains two different types of lines. 
Note that all specifications of this part are required, 
although their order is arbitrary. 


5/86 =is 


5/86 


1. 


3. 
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Root / pipe device specification 
Two lines of three fields each: 


root devname minor 
pipe devname minor 


where minor is the minor device number (in octal) of the 
slice on the winchester. 


Swap device specification 


One line that contains five fields, and one line that 
contains three fields, as follows: 


swap devname minor swplo  nswap 


where swplo is the lowest disk block (decimal) in the 
swap area and nswap is the maximum number of IK- 
byte disk blocks (decimal) in the swap area. The kernel 
sizes the actual swap area size and configures itself for 
up to this maximum. 


Parameter specification 


There are any number of lines of two fields each, chosen 
from the following list. Number is decimal. This list is 
not complete; parameters not on the list either must not 
be changed or have no effect. 


buffers number /* number of 1024-byte file system 
caching buffers * / 

dmmxsz number 

/* max number of pages per 

loadable driver */ 

inodes number /* max open inodes in system */ 
files | number /* max open files in system */ 
nflocks number /* max locks active in system * 
mounts number /* max file systems mounted * 
regions number /* total number of regions in system */ 
procs number /* max processes in system */ 
maxproc number 

/* max processes per user ID */ 
maxfsiz number /* ulimit default in 512-byte blocks */ 
maxumem number 

/* max number of pages per process */ 
cbufsize number 

* console circular buffer size in bytes */ 

mesg Oorl /* configure for messages */ 
msgmax number 

/* max chars in a message */ 
msgmni number 

/* max active message queues */ 
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msgmnb number 
/ * 


msgtql number /* 
msgssz number 
msgseq number /* 


nildrv number /* 
sem Oorl /* 
semmni number /* 
semmns number /* 
semmsi number /* 
semopm number 

* 
semume number /* 
semmnu number 


/* 


diriosz number /* 
shmem Oorl /* 
shmmax number 

* 
shmmin number /* 
shmmninumber /* 
shmseg number /* 
shmbrk number /* 


debugger 0 or 1 /* 


max total chars in message 
queues */ 
max messages in system */ 


msgssz * msgseq = number bytes of 
system buffering */ 
max number of loadable drivers */ 
configure for semaphores */ 
max active semaphores */ 
max semaphores in system */ = 
max semaphores per ID */ 


max operations per semop call */ 
max undo structures per process * / 


max undo structures in 

system */ 
direct I/O default size */ 
configure for shared memory */ 


max bytes in a shared segment */ 

min bytes in a shared segment */ 

max active shared segments */ 

max attached segments per process */ 

gap in pages between data and 
shared memory */ | 

configure low-level 
kernel debugger */ 


Certain parameters if set to 0 will allow the kernel to 
autoconfigure. Procs, regions, clists, i-nodes, files, and 
buffers are autoconfigurable. The number of procs is 
based on the number of users; regions, i_nodes, and files 
are based on the number of procs. The number of clists 
is based on the number of serial and cluster ports. The 
number of buffers is based on the amount of physical 
memory. Any or all of these may be overridden. 
Maxumem may also be set to 0, in which case it floats 
between 1M byte plus one quarter of the total swap 
space. 


EXAMPLE 
To configure a system with the following devices: 


Onboard quarter-inch tape 

Onboard ST506 disks (root) 

Interphase SMD disk controller 

RS-232-C (any number of ports) 

one parallel line printer 

root device is a winchester (drive 0, section 1) 
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pipe device is a winchester (drive 0, section 1) 

swap device is a winchester (drive 0, section 2), 
with a swplo of 1 and an nswap of 8000 

number of buffers is 100 

number of processes is 100 

maximum number of processes per user ID is 25 

number of mounts is 6 

number of inodes is 100 

number of files is 120 

number of character buffers is 64 

messages are to be included 

semaphores are to be included 


The actual system configuration would be specified as 


follows: 
diskonbd 
Vsmd3200 
serial 
qic 
console 
plp 
root diskonbd 01 
pipe diskonbd 01 
swap diskonbd 02 0 8000 
* Comments may be inserted in this manner 
buffers 100 
procs 100 
maxproc 25 
mounts 6 
inodes_ 100 
files 120 
mesg 1 
sema 1 
clists 64 
FILES 
(mens default input master device table 
ow.s default output hardware interface file 
conf.c default output configuration table file 
SEE ALSO 


Ideeprom(1M), master(4). 

MightyFrame Administrator’s Reference Manual. 
DIAGNOSTICS 

Diagnostics are routed to the standard output and are 

self-explanatory. 


BUGS 
The —t option does not know about devices that have 
aliases. 
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NAME 


CONLOCATE( 1M) 


conlocate — locate a terminal to use as the virtual 
system console 


SYNOPSIS 


/ete/conlocate [| —r | { —in | [| -t ] 


DESCRIPTION 


FILES 


Conlocate searches for a terminal to use as the system 
console, /dev/syscon. It scans /etc/inittab for 
terminals that get a getty(1M) in state 6, and spawns 
children to monitor the terminals for attempted logins. 
Each child does all the I/O control and login verification 
of the getty-login sequence, but only root is actually 
permitted to log in. The first terminal to have root log 
in has its tty linked to /dev/syscon. Conlocate then 
writes the new virtual system console’s communication 
options, which have just been set from the values in 
/ete/gettydefs, to its own standard output, using 
stty(1) —g format. 


Conlocate understands the following options: 


-r If /dev/syscon exists and is openable, exit 
without scanning for a new one. 


—in Scan run level n instead of run level 6. 


-t Begin by monitoring for logins on the existing 
/dev/syscon. If root logs in at that terminal 
within 20 seconds, abandon the search for 
another console. 


/dev/syscon __ virtual system console 
/etc/inittab definitions of operating states 
/ete/gettydefs communication options 


SEE ALSO 


init (1M), stty(1), gettydefs(4), inittab(4), termio(7). 


WARNING 


Beware of collision with other processes that might be 
trying to open the same terminals, especially gettys 
spawned by intt. 
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NAME 
convert — convert object and archive files to common 
formats 

SYNOPSIS 
convert [-5] infile outfile 

DESCRIPTION 


Convert transforms input infile to output outfile. Infile 
must be different from outfile. The —5 option causes 
convert to work exactly as it did for UNIX system release 
5.0. Infile may be any one of the following: 


1) a pre-UNIX system 5.0 object file or 
link-edited (a.out) module (only with the 
—5 option), 

2) a pre-UNIX system 5.0 archive of object 


files or link edited (a.out) modules (only 
with the —5 option), or 


3) a UNIX system 5.0 archive file (without 
the —5 option). 


Convert will transform tnfile to one of the following 
(respectively): 


1) an equivalent UNIX system 5.0 object 
file or link edited (a.out) module (with 
the —5 option), 


2) an equivalent UNIX system 5.0 archive 
of equivalent object files or link edited 
(a.out) modules (with the —5 option), 
and 


3) an equivalent UNIX system 5.0 release 
2.0 portable archive containing 
unaltered members (without the —5 
option). 


All other types of input to the convert command will be 
passed unmodified from the input file to the output file 
(along with appropriate warning messages). When 
transforming archive files with the -—5 option, the 
convert(1) command will inform the user that the 
archive symbol table has been deleted. To generate an 
archive symbol table, this archive file must be 
transformed again by convert without the —5 option to 
create a UNIX system 5.0 archive file. Then the archive 
symbol table may be created by executing the ar(1) 
command with the ts option. If a UNIX system 5.0 
archive with an archive symbol table is_ being 
transformed, the archive symbol table will automatically 
be converted. 
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FILES 
/tmp/conv* 
SEE ALSO 
ar(1), arcv(1), a.out(4), ar(4). 
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NAME 

cp, In, mv — copy, link or move files 
SYNOPSIS 

ep filel [ file2 “4 target 

In [| -f ] filel [ file2 ...] target 

mv | —f | filel [ file2 ...] target 
DESCRIPTION 


Filet is copied (linked, moved) to target. Under no 
circumstance can file1 and target be the same (take care 
when using sh(1) and csh(1) metacharacters). If target 
is a directory, then one or more files are copied (linked, 
moved) to that directory. If target is a file, its contents 
are destroyed. 


If mv or In determines that the mode of target forbids 
writing, it will print the mode (see chmod(2)), ask for a 
response, and read the standard input for one line (if the 
standard input is a terminal); if the line begins with y, 
the mv or In occurs, if permissible; if not, the command 
exits. No questions are asked and the mv or In is done 
when the -—f option is used or if the standard input is not 
a terminal. 


Only mv will allow file! to be a directory, in which case 
the directory rename will occur only if the two 
directories have the same parent; file1 is renamed target. 
If file1 is a file and target is a link to another file with 
ne the other links remain and target becomes a new 
file. 


When using ep, if target is not a file, a new file is 
created which has the same mode as file1 except that the 
sticky bit is not set unless you are super-user; the owner 
and group of target are those of the user. If target is a 
file, copying a file into target does not change its mode, 
owner, nor group. The last modification time of target 
(and last access time, if target did not exist) and the last 
access time of filel are set to the time the copy was 
made. If target is a link to a file, all links remain and 
the file is changed. 


SEE ALSO 


epio(1), rm(1), chmod(2). 


WARNING 


When the destination of a copy is a file that already 
exists, cp will try to overwrite it, not remove it; this 
preserves the destination files ownership, and so forth. If 
the destination file has an ownership you do not want, 
remove it before doing the copy. 


BUGS 
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If filet and target lie on different file systems, mv must 
copy the file and delete the original. In this case the 
owner name becomes that of the copying process and 
any linking relationship with other files is lost. 


Ln will not link across file systems. 


NAME 
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cpio — copy file archives in and out 


SYNOPSIS 


cpio —o [ acBQv | 
cpio -i | BQcdmrtuvfsSb6 | [ patterns | 
cpio —p [| adlmuv | directory 


DESCRIPTION 


Cpio —o (copy out) reads the standard input to obtain a 
list of path names and copies those files onto the 
standard output together with path name and status 
information. Output is padded to a 512-byte boundary. 


Cpio -i (copy in) extracts files from the standard input, 
which is assumed to be the product of a previous cpio 
—o. Only files with names that match patterns are 
selected. Patterns are given in the name-generating 
notation of sh(1). In patterns, meta-characters ?, *, and 

]. match the slash / character. Multiple patterns 
may be specified and if no patterns are specified, the 
default for patterns is * (i.e., select all files). The 
extracted files are conditionally created and copied into 
the current directory tree based upon the options 
described below. The permissions of the files will be 
those of the previous cpio —o. The owner and group-of 
the files will be that of the current user unless the user is 
super-user, which causes cpto to retain the owner and 
group of the files of the previous cpio —o. 


Cpio —p (pass) reads the standard input to obtain a list 
of path names of files that are conditionally created and 
copied into the destination directory tree based upon the 
options described below. 


The meanings of the available options are: 


a Reset access times of input files after they have 
been copied. 
B Input/output is to be blocked 5,120 bytes to the 


record (does not apply to the pass option; 
meaningful only with data directed to or from 
{ dev/rmt?? or raw floppy disks). 

nput/output is to be blocked 65,536 bytes to 
the record. Works like —B option, with which it 
is mutually exclusive. The —Q option optimizes 
quarter-inch tape access. 

d Directories are to be created as needed. 

Write header information in ASCII character 
form for portability. 
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r Interactively rename files. If the user types a 
null line, the file is skipped. 

t Print a table of contents of the input. No files 
are created. 

u Copy unconditionally (normally, an older file will 
not replace a newer file with the same name). 

Vv Verbose: causes a list of file names to be 


printed. When used with the t option, the table 
of contents looks like the output of an Is —1 
command (see /s(1)). 
] Whenever possible, link files rather than copying 
them. Usable only with the —p option. 
m Retain previous file modification time. This 
option is ineffective on directories that are being 
copied. 
Copy in all files except those in patterns. 
Swap bytes. Use only with the —i option. 
Swap halfwords. Use only with the —i option. 
Swap both bytes and halfwords. Use only with 
the —i option. 
Process an old (i.e., UNIX System Sizth Edition 
format) file. Only useful with —i (copy in). 
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EXAMPLES 


The first example below copies the contents of a 
directory into an archive; the second duplicates a 
directory hierarchy: 


Is | cpio -o >/dev/mt0 


ed olddir 
find . —depth —print | cpio -pdl newdir 


The trivial case ‘find . -depth ~print | cpio -—oB 
> /dev/rmt0” can be handled more efficiently by: 


find . -—cpio /dev/rmt0 


SEE ALSO 


NOTES 


BUGS 


ar(1), find(1), cpio(4). 


The ~Q option can be used with the —p option to 
improve performance, but at the penalty of using more 
memory. 


Path names are restricted to 128 characters. If there are 
too many unique linked files, the program runs out of 
memory to keep track of them and, thereafter, linking 
information is lost. Only the super-user can copy special 
files. 
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NAME 

cpp — the C language preprocessor 
SYNOPSIS 

/lib/epp [ option ... ] [ ifile [ ofile ] |] 
DESCRIPTION 


Cpp is the © language preprocessor which is invoked as 
the first pass of any C compilation using the cec(1) 
command. Thus the output of cpp is designed to be in a 
form acceptable as input to the next pass of the C 
compiler. As the C language evolves, cpp and the rest of 
the C compilation package will be modified to follow 
these changes. Therefore, the use of cpp other than in 
this framework is not suggested. The preferred way to 
invoke cpp is through the ec(1) command, since the 
functionality of cpp may someday be moved elsewhere. 
See m4(1) for a general macro processor. 


Cpp optionally accepts two file names as arguments. 
Ifile and ofile are respectively the input and output for 
the preprocessor. They default to standard input and 
standard output if not supplied. 


The following options to cpp are recognized: 


~-P Preprocess the input without producing the line 
control information used by the next pass of the 
C compiler. 


-C By default, cpp strips C-style comments. If the 
—C option is specified, all comments (except 
those found on cpp directive lines) are passed 
along. 


—Uname 
Remove any initial definition of name, where 
name is a reserved symbol that is predefined by 
the particular preprocessor. The current list of 
these possibly reserved symbols includes: 


operating system: 
ibm, gcos, os, tss, unix 


hardware: interdata, pdp11, u370, ub, 
u3b5, vax, mc68k, mc68000, 
mc68010, mc68020 


system variants: RES, RT 


line(1): lint 
—Dname 
—Dname=def 


Define name as if by a #define directive. If no 
def is given, name is defined as 1. The —D 
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option has lower precedence that the —U option. 
That is, if the same name is used in both a —U 
option and a —D option, the name will be 
undefined regardless of the order of the options. 


—-T Preprocessor symbols are no longer restricted to 
eight characters. The —T option forces cpp to 
use only the ffirst eight characters for 
distinguishing different preprocessor names. 
This behavior is the same as_ previous 
preprocessors with respect to the length of names 
and is included for backward compatability. 


—Idir Change the algorithm for searching for 
#include files whose names do not begin with / 
to look in dtr before looking in the directories on 
the standard list. Thus, #include files whose 
names are enclosed in * ” will be searched for 
first in the directory of the file with the 
#include line, then in directories named in —I 
options, and last in directories on a standard list. 
For #include files whose names are enclosed in 
<>, the directory of the file with the #include 
line is not searched. By default, cpp searches for 
the name enclosed in < > in /usr/include; 
however, if the shell variable INCROOT is set, 
cpp prepends the value of INCROOT to the 
standard list. This is particularly useful for 
cross-machine compilation. 


Two special names are understood by cpp. The name 
__LINE_ _ is defined as the current line number (as a 
decimal integer) as known by cpp, and __FILE__ is 
defined as the current file name (as a C string) as known 
by cpp. They can be used anywhere (including in 
macros) just as any other defined name. 


All cpp directives start with lines begun by #. Any 
number of blanks and tabs are allowed between the # 
and the directive. The directives are: 


#define name token-string 
Replace subsequent instances of name with 
token-string. 


#define name( arg, ..., arg ) token-string 
Notice that there can be no space between name 
and the (. Replace subsequent instances of name 
followed by a (, a list of comma-separated set of 
tokens, and a ) by token-string, where each 
occurrence of an arg in the token-string is 
replaced by the corresponding token in the 
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comma-separated list. When a macro with 
arguments is expanded, the arguments are 
placed into the expanded  token-string 
unchanged. After the entire token-string has 
been expanded, cpp re-starts its scan for names 
to expand at the beginning of the newly created 
token-string. 


#undef name 
Cause the definition of name (if any) to be 
forgotten from now on. 


#include " filename” 

#include < filename > 
Include at this point the contents of filename 
(which will then be run through cpp). When the 
<filename > notation is used, filename is only 
searched for in the standard places. See the —I 
option above for more detail. 


#fline integer-constant " filename” 
Causes cpp to generate line control information 
for the next pass of the C compiler. JInteger- 
constant is the line number of the next line and 
filename is the file where it comes from. If 
"filename" is not given, the current file name is 
unchanged. 


#endif 
Ends a section of lines begun by a test directive 
(#if, #ifdef, or #ifndef). Each test directive 
must have a matching #endif. 


#ifdef name 
The lines following will appear in the output if 
and only if name has been the subject of a 
previous #define without being the subject of 
an intervening #undef. 


#ifndef name 
The lines following will not appear in the output 
if and only if name has been the subject of a 
previous #define without being the subject of 
an intervening #undef. 


#if constant-ezpression 
Lines following will appear in the output if and 
only if the constant-erpression evaluates to non- 
zero. All binary non-assignment C operators, 
the ?: operator, the unary —, !, and ~ operators 
are all legal in constant-expresston. The 
precedence of the operators is the same as 
defined by the C language. There is also a 
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unary operator defined, which can be used in 
constant-ezpression in these two forms: defined 
( name ) or defined name. This allows the 
utility of #ifdef and #ifndef in a #if directive. 
Only these operators, integer constants, and 
names which are known by cpp should be used in 
constant-erpresston. In particular, the sizeof 
operator is not available. 


#else Reverses the notion of the test directive which 
matches this directive. So if lines previous to 
this directive are ignored, the following lines will 
appear in the output. And vice versa. 


The test directives and the possible #else directives can 


be nested. 
FILES 
/usr/include standard directory for #include 
files 
SEE ALSO 
ec(1), m4(1). 
DIAGNOSTICS 


The error messages produced by cpp are intended to be 
self-explanatory. The line number and filename where 
the error occurred are printed along with the diagnostic. 


NOTES 
When new-line characters were found in argument lists 
for macros to be expanded, previous versions of cpp put 
out the new-lines as they were found and expanded. The 
current version of cpp replaces these new-lines with 
blanks to alleviate problems that the previous versions 
had when this occurred. 
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NAME 

cpset — install object files in binary directories 
SYNOPSIS 

epset [-o] object directory [mode owner group] 
DESCRIPTION 


Cpset is used to install the specified object file in the 
given directory. The mode, owner, and group, of the 
destination file may be specified on the command line. 
If this data is omitted, two results are possible: 


If the user of ecpset has administrative 
permissions (that is, the user’s numerical ID is 
less than 100), the following defaults are 
provided: 


mode — 0755 
owner — bin 
group — bin 
If the user is not an administrator, the default, 


owner, and group of the destination file will be 
that of the invoker. 


An optional argument of ~—o will force cpset to move 
object to OLDobject in the destination directory before 
installing the new object. 


For example: 
cpset echo /bin 0755 bin bin 
cpset echo /bin 
cpset echo /bin/echo 


All the examples above have the same effect (assuming 
the user is an administrator). The file echo will be 
copied into /bin and will be given 0755, bin, bin as the 
mode, owner, and group, respectively. 


Cpset utilizes the file /usr/src/destinations to 
determine the final destination of a file. The locations 
file contains pairs of pathnames separated by spaces or 
tabs. The first name is the “official” destination (for 
example: /bin/echo). The second name is the new 
destination. For example, if echo is moved from /bin to 
cusry Pin, the entry in /usr/src/destinations would 
e: 


/bin/echo /usr/bin/echo 


When the actual installation happens, cpset verifies that 
the “old” pathname does not exist. If a file exists at 
that location, cpset issues a warning and continues. This 
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file does not exist on a distribution tape; it is used by 
sites to track local command movement. The procedures 
used to build the source will be responsible for defining 
the "official” locations of the source. 


Cross Generation 
The environment variable ROOT will be used to locate 
the destination file (in the form 
$ROOT/usr/sre/destinations). This is necessary in 
the cases where cross generation is being done on a 
production system. 


SEE ALSO 
install(1M), make(1). 


NAME 


CRASH(1M) 


crash — examine system images 


SYNOPSIS 


/etc/crash [ system | { namelist | 


DESCRIPTION 


Crash is an interactive utility for examining an 
operating system core image. It has facilities for 
interpreting and formatting the various control 
structures in the system and certain miscellaneous 
functions that are useful when perusing a dump. 


The arguments to crash are the file name where the 
system image can be found and a namelist file to be 
used for symbol values. 


The default values are /dev/kmem and /unix; hence, 
crash with no arguments can be used to examine an 
active system. If a system image file is given, it is 
assumed to be a system core dump and the default 
process is set to be that of the process running at the 
time of the crash. This is determined by a value stored 
in a fixed location by the dump mechanism. 


The system image may be /dev/kmem, regular files, or 
partition zero of a disk. 


COMMANDS 


Input to crash is typically of the form: 
command | options | [ structures to be printed |. 


When allowed, opttons will modify the format of the 
printout. If no specific structure elements are specified, 
all valid entries will be used. As an example, proce — 12 
15 3 would print process table slots 12, 15, and 3 in a 
long format, while proce would print the entire process 
table in standard format. 


In general, those commands that perform I/O with 
addresses assume hexadecimal on 32-bit machines and 
octal on 16-bit machines. 


The current repertory consists of: 


user | list of process table entries | 
Aliases: uarea, u_area, u. 
Print the user structure of the named process as 
determined by the information contained in the 
process table entry. If no entry number is given, 
the information from the last executing process 
will be printed. Swapped processes produce an 
error message. 
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conbuf 
Print the console buffer. 


trace ise { list of process table entries | 
iases: t. 

Generate a kernel stack trace of the current 
process. If the —r option is used, the trace 
begins at the saved stack frame pointer in kfp. 
Otherwise the trace starts at the value of the fp 
stored in u_rsav. If no entry number is given, 
the information from the last executing process 
will be printed. 


kfp [ stack frame pointer | 
Aliases: r6, fp. 
Print the program’s idea of the start of the 
current stack frame (set initially from a fixed 
location in the dump) if no argument is given, or 
set the frame pointer to the supplied value. 


stack [ list of process table entries | 
Aliases: stk, s, kernel, k. 
Format a dump of the kernel stack of a process. 
The addresses shown are virtual system data 
addresses rather than true physical locations. If 
no entry number is given, the information from 
the last executing process will be printed. 


proc [| —(r] | { list of process table entries | 
liases: ps, p. 
Format the process table. The —r option causes 
only runnable processes to be printed. The — 
alone generates a longer listing. 


i-node | — | { list of inode table entries | 
Aliases: ino, 1. 
Format the i-node table. The — option will also 
print the i-node data block addresses. 


file | list of file table entries ] 
Aliases: files, f. 
Format the file table. 


Ick Aliases: 1] 
Print the active and sleep record lock tables; 
also verify the correctness of the record locking 
linked lists. 


mount | list of mount table entries | 
Aliases: mnt, m. Format the mount table. 
tty [ type | [ — | [ list of tty entries | 
Aliases: term, pt, gt, ser. 
Print the tty structures. The type argument 
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determines which structure will be used (such as 
pt or ser; the last type is remembered.) The — 
option prints the stty{1) parameters for the given 
line. 


Print certain statistics found in the dump. 
These include the panic string (if a panic 
occurred), time of crash, system name, and the 
registers saved in low memory by the dump 
mechanism. 


Aliases: tunables, tunable, tune, v. 
Print the tunable system parameters. 


buf | options | { list of buffer headers | 


Aliases: hdr, bufhdr. 

Format the system buffer headers. With no 
parameters, all buffer headers are shown. With 
no options but a list of indexes or addresses, only 
the specified buffer headers are shown. With an 
option and a single index or address, the chain of 
buffer headers beginning at the specified buffer 
pee is shown. Various option show various 
chains: 


-a Trace the available chain both ways by 
following both the av_forw and av_back 
fields in the headers. 


—af Trace the available chain by following 
the av_forw fields. 


-ab = Trace the available chain by following 
the av_back. fields. 

-f Trace the chain for the device by 
following the 6_forw fields. —b Trace 
the chain for the device by following the 
b_back fields. 

—n Follow the 6_forw, b_back, av_forw, and 
av_back fields for n headers each. 

- Follow the b_forw, b_back, av_forw, and 
av_back fields all the way through their 
chains. 


buffer | format | | list of buffers | 


Alias: b. 

Print the data in a system buffer according to 
format. If format is omitted, the previous 
format is used. Valid formats include decimal, 
octal, hex, character, byte, directory, i- 
node, and write. The last creates a file in the 
current directory (see FILES) containing the 
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buffer data. 


callout 
Aliases: calls, call, c, timeout, time, tout. 
Print all entries in the callout table. 


region ees table number pres table address | 
rints region table. Region table address must 
be of the form Ox ... . 


disk Print the GD disk tables. 


feallout 
Aliases: fcalls, feall, fe, ftimeout, ftime, 
ftout. 
Print all entries in the fcallout table. 


map [ list of map names | 
Format the named system map structures. 


nm [ list of symbols | 
Print symbol value and type as found in the 
nameltst file. 


ts [ list of text addresses | 
Find the closest text symbols to the given 
addresses. 


ds | list of data addresses | 
Find the closest data symbols to the given 
addresses. 


cblk [ - 
F ormat the cblock table. The — option checks 
cblock usage. 


pm [ symbol name or address | | count | | format | 


od [ symbol name or address | { count | { format ] 
Aliases: dump, rd. 
Dump count data values starting at the symbol 
value or address given according to format. Od 
dumps virtual addresses; pm dumps physical 


addresses. Allowable formats are octal, 
longoct, decimal, longdec, character, hex, or 
byte. 


shm | ea [ list of shared memory header table entries | 
ormat the shared memory header table. If the 
~ option is used, also display information about 
the last change, the last shmop, and attached 
processes. 


shminfo 


Display the system’s shared memory information 
structure. 
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msg | se [list of ipe message queue header table Sore 
ormat the ipc message queu header table. 
the — option is used, also display information 
about the last change, the last msgop, and any 
messages on the queue contained in the message 
headers. 


msginfo 
Print the system message information structure. 


msgtext {| format | 


[ list of ipe message queue header table entries | 
Print the text of the messages on a queue 
according to format. If format is omitted, the 
previous format is used. 


! Escape to shell. 
q Exit from crash. 


notify [| list of notification table entries | 
Print a requested notification. 


unotify i list of process table entries | 
rint queued notifications for given process. 


? [ start letter | 
Print synopsis of commands. Optional start 
letter prints only those commands beginning 
with that letter. 


pfdat | list of page frame numbers | 
Alias: pf 
Print information about a physical page of 
memory. 


pfree | a [ list of page frame numbers | 
If no options are given, print out number of 
pages on free list. With the option ’-’, print all 
pages on free list. Giving a specific page number 
simply reports whether that page is on the free 


list. 


phash [ list of hash slots | 
Alias: ph 
Print hash lists of physical pages. With no 
arguments, print all hash lists with their 
respective pages. 

pregion | list of process table entries | 
Alias: prg 
Print currently attached regions of a process. 


w Print toggle warning. Primarily useful in 
tracking virtual to physical address translations. 


ALIASES 
There are built-in aliases for many of the formats as well 
as those listed for the commands. Some of them are: 

b 
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character 
decimal 
FORMATS AND FORMAT ALIASES 

Here are the standard formats and format aliases: 


Format 
byte 
bytedec 
byteoct 
bytehex 
character 
worddec 


wordoct 
wordhex 
longdec 
longoct 
longhex 
directory 
inode 
write 


char, c. 
dec, ec. 


Meaning Aliases 

byte 

byte of decimal bd 

byte of octal bo 

byte of hexadecimal bh, bx 

ASCII character char, c 

2 bytes wd, decimal, 
dec, e 

2 bytes wo, octal, oct, o 

2 bytes wx, wh 

4 bytes Id, D 

4 bytes lo, O 

4 bytes lx, X, hex, h, x 

directory direct, dir, d 

inode ino, i 

write w 


/usr/include/sys/*.h header files for table and structure 


/dev/kmem 
unix 


uf. # 


SEE ALSO 
mount(1M), nm(1), ps(1), sh(1), stty(1). 
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default system image file 

default namelist file 

files created containing buffer data 
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NAME 
cron — clock demon 
SYNOPSIS 
/etc/cron 
DESCRIPTION 
Cron executes commands at specified dates and times. 
Regularly scheduled commands can _ be specified 
according to the instructions found in crontab files; users 
can submit their own crontab file via the crontab 
command, Commands which are to be executed only 
once may be submitted via the af command. Since cron 
never exits, it should be executed only once. This is best 
done by running cron from the initialization process 
through the file Vkeles (see intt(1M)). 
Cron only examines crontab files and at command files 
during process initialization and when a file changes. 
This reduces the overhead of checking for new or 
changed files at regularly scheduled intervals. 
FILES 
/usr/lib/cron 
main cron directory 
/usr/lib/cron/log 
accounting information 
/usr/spool/cron 
spool area 
SEE ALSO 
at(1), crontab(1), init(1M), sh(1). 
MightyFrame Administrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 
DIAGNOSTICS 
A history of all actions taken by cron are recorded in 
/usr/lib/cron/log. 
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crontab - user crontab file 


SYNOPSIS 


crontab [file] 
crontab -r 
crontab -1 


DESCRIPTION 
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Crontab copies the specified file, or standard input if no 
file is specified, into a directory that holds all users’ 
crontabs. The —r option removes a user’s crontab from 
the crontab directory. Crontab —1 will list the crontab 
file for the invoking user. 


A user is permitted to use crontab if his name appears in 
the file /usr/lib/cron/cron.allow. If that file does not 
exist, the file /usr/lib/cron/cron.deny is checked to 
determine if the user should be denied access to crontab. 
If neither file exists, only root is allowed to submit a job. 
If cron.deny exists and is emtpy, global usage is 
permitted. If cron.allow exists and is empty, no usage 
is permitted. If cron.allow exists, cron.deny is 
ignored. The allow/deny files consist of one user name 
per line. 


A crontab file consists of lines of six fields each. The 
fields are separated by spaces or tabs. The first five are 
integer patterns that specify the following: 


minute (0-59), 

hour (0-23), 

day of the month (1-31), 

month of the year (1-12), 

day of the week (0-6 with 0—Sunday). 


Each of these patterns may be either an asterisk 
(meaning all legal values), or a list of elements separated 
by commas. An element is either a number, or two 
numbers separated by a minus sign (meaning an 
inclusive range). Note that the specification of days may 
be made by two fields (day of the month and day of the 
week). If both are specified as a list of elements, both 
are adhered to. For example, 0 0 1,15 * 1 would run a 
command on the first and fifteenth of each month, as 
well as on every Monday. To specify days by only one 
field, the other field should be set to * (for example, 0 0 
* * 1 would run a command only on Mondays). 


The sixth field of a line in a crontab file is a string that 
is executed by the shell at the specified times. A percent 
character in this field (unless escaped by \) is translated 
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to a new-line character. Only the first line (up to a % or 
end of line) of the command field is executed by the 
shell. The other lines are made available to the 
command as standard input. 


The shell is invoked from your $HOME directory with 
an argO of sh. Users who desire to have their .profile 
executed must explicitly do so in the crontab file. Cron 
supplies a default environment for every shell, defining 
HOME, LOGNAME, SEE onan) TZ, and 
PATH(=:/bin:/usr/bin:/usr/local/bin). 

NOTE: Users should remember to redirect the standard 
output and standard error of their commands! If this is 
not done, any generated output or errors will be mailed 
to the user. 


FILES 
/usr/lib/cron main cron directory 
/usr/spool/cron/crontabs spool area 
/usr/lib/cron/log accounting information 
/usr/lib/cron/cron.allow list of allowed users 
/usr/lib/cron/cron.deny list of denied users 
SEE ALSO 
cron(1M), sh(1). 
MightyFrame Administrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 
BUGS 


Crontab runs sh even if your login shell is esh. 


NAME 
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esh ~ a shell (command interpreter) with C-like syntax 


SYNOPSIS 


esh { —cefinstvVxX | { arg... ] 


DESCRIPTION 
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Ceh is a first implementation of a command language 
interpreter incorporating a history mechanism ieee 
History Substitutions) job control facilities (see Jobs) 


and a C-like syntax. 


An instance of csh begins by executing commands from 
the file .eshre in the home directory of the invoker. If 
this is a login shell, then it also executes /etc/cprofile 
and commands from the file .login there. It is typical 
for users on crt’s to put ¢set(1) in their .login files. 


In the normal case, the shell will then begin reading 
commands from the terminal, prompting with ‘% ’. 
Processing of arguments and the use of the shell to 
process files containing command scripts will be 
described later. 


The shell then repeatedly performs the following actions: 
a line of command input is read and broken into words. 
This sequence of words is placed on the command history 
list and then parsed. Finally each command in the 
current line is executed. 


When a login shell terminates, it executes commands 
from the file .logout in the user’s home directory. 


Lexical structure 


The shell splits input lines into words at blanks and tabs 

with the following exceptions. The characters & |; < 
> ( form separate words. If doubled in &&, | |, 
<<or>> these pairs form single words. These parser 

metacharacters may be made part of other words, or 
revented their special meaning, by preceding them with 
. A newline preceded by a \ is equivalent to a blank. 


In addition strings enclosed in matched pairs of 
quotations, °, *, or ” form parts of a _ word; 
metacharacters in these strings, including blanks and 
tabs, do not form separate words. These quotations have 
semantics to be described subsequently. Within pairs of 
“ or ” characters, a newline preceded by a \ gives a true 
newline character. 


When the shell’s input is not a terminal, the character # 
introduces a comment which continues to the end of the 
input line. It is prevented this special meaning when 
preceded by \ and in quotations using *, *, and ”. 
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Commands 


A simple command is a sequence of words, the first of 
which specifies the command to be executed. A simple 
command or a sequence of simple commands separated 
by the | character forms a pipeline. The output of each 
command in a pipeline is connected to the input of the 
next. Sequences of pipelines may be separated by ‘;’, 
and are then executed sequentially. A sequence of 
pipelines may be executed without immediately waiting 
for it to terminate by following it with an &. 


Any of the above may be placed in ( ) to form a simple 
command (which may be a component of a pipeline, etc.) 
It is also possible to separate pipelines with | or && 
indicating, as in the C language, that the second is to be 
executed only if the first succeeds or fails, respectively. 
(See Expresstons.) 


Jobs 


The shell associates a job with each pipeline. It keeps a 
table of current jobs, printed by the jobs command, and 
assigns them small integer numbers. When a job is 
started asynchronously with &, the shell prints a line 
which looks like: 


[1] 1234 


indicating that the jobs which was _ started 
asynchronously was job number | and had one (top- 
level) process, whose process id was 1234. 


The shell maintains a notion of the current and previous 
jobs. In output pertaining to jobs, the current job is 
marked with a + and the previous job with a —. 


Status reporting 


This shell learns immediately whenever a process 
changes state. It normally informs you whenever a job 
becomes blocked so that no further progress is possible, 
but only just before it prints a prompt. This is done so 
that it does not otherwise disturb your work. If, 
however, you set the shell variable notzfy, the shell will 
notify you immediately of changes of status in 
background jobs. There is also a shell command notify 
which marks a single process so that its status changes 
will be immediately reported. By default notify marks 
the current process; simply say ‘notify’ after starting a 
background job to mark it. 
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Substitutions 


We now describe the various transformations the shell 
performs on the input in the order in which they occur. 


History substitutions 


History substitutions place words from previous 
command input as portions of new commands, making it 
easy to repeat commands, repeat arguments of a 
previous command in the current command, or fix 
spelling mistakes in the previous command with little 
typing and a high degree of confidence. History 
substitutions begin with the character ! and may begin 
anywhere in the input stream (with the proviso that 
they do not nest.) This ! may be preceded by a \ to 
prevent its special meaning; for convenience, a ! is passed 
unchanged when it is followed by a blank, tab, newline, 
= or (. (History substitutions also occur when an input 
line begins with ¢. This special abbreviation will be 
described later.) Any input line which contains history 
substitution is echoed on the terminal before it is 
executed as it could have been typed without history 
substitution. 


Commands input from the terminal which consist of one 
or more words are saved on the history list. The history 
substitutions reintroduce sequences of words from these 
saved commands into the input stream. The size of 
which is controlled by the Atstory variable; the previous 
command is always retained, regardless of its value. 
Commands are numbered sequentially from 1. 


For definiteness, consider the following output from the 
history command: 


9 write michael 
10 ex write.c 

11 cat oldwrite.c 
12 diff *write.c 


The commands are shown with their event numbers. It 
is not usually necessary to use event numbers, but the 
current event number can be made part of the prompt by 
placing ! in the prompt string. 

With the current event 13 we can refer to previous 
events by event number !11, relatively as in !—2 
(referring to the same event), by a prefix of a command 
word as in !d for event 12 or !wri for event 9, or by a 
string contained in a word in the command as in !?mic? 
also referring to event 9. These forms, without further 
modification, simply reintroduce the words of the 
specified events, each separated by a single blank. As a 
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special case !! refers to the previous command; thus !! 
alone is essentially a redo. 


To select words from an event we can follow the event 
specification by : and a designator for the desired words. 
The words of a input line are numbered from 0, the first 
(usually command) word being 0, the second word (first 
argument) being 1, etc. The basic word designators are: 


0 first (command) word 

n n’th argument 

{ first argument, i.e., 1 
last argument 

% word matched by (immediately preceding) ?s? 
search 

z-y range of words 

-y abbreviates O— 

* abbreviates 1-3, or nothing if only one word in 
event 

a* abbreviates z —$ 

r- like z * but omitting word ‘$’ 


The : separating the event specification from the word 

designator can be omitted if the argument selector begins 

with a f, $, *#, —, or %. After the optional word 

designator can be placed a sequence of modifiers, each 

preceded by a:. The following modifiers are defined: 
Remove a trailing pathname component, leaving 
the head. 

r Remove a trailing .xxx component, leaving the 
root name. 

e Remove all but the extension .xxx part. 

s/l/r / 


Substitute / for r 


t Remove all leading pathname components, 
leaving the tail. 

& Repeat the previous substitution. 

g Apply the change globally, prefixing the above, 
e.g., S&. 

p Print the new command but do not execute it. 

q Quote the substituted words, preventing further 
substitutions. 

x Like q, but break into words at blanks, tabs and 
newlines. 


Unless preceded by a ‘g’ the modification is applied only 
to the first modifiable word. With substitutions, it is an 
error for no word to be applicable. 

The left hand side of substitutions are not regular 
expressions in the sense of the editors, but rather strings. 
Any character may be used as the delimiter in place of 
/; a \ quotes the delimiter into the / and r strings. The 
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& character in the right hand side is replaced by the 
text from the left. A \ quotes & also. A null / uses the 
previous string either from a / or from a contextual scan 
string 8 in !%8?. The trailing delimiter in the 
substitution may be omitted if a newline follows 
immediately as may the trailing ‘?’ in a contextual scan. 

A history reference may be given without an event 
specification, e.g. ‘!$’. In this case the reference is to the 
previous command unless a previous history reference 
occurred on the same line in which case this form repeats 
the previous reference. Thus !?foo?f !$ gives the first 
and last arguments from the command matching ?foo?. 

A special abbreviation of a history reference occurs when 
the first non-blank character of an input line is a ‘f’. 
This is equivalent to !:sf providing a convenient 
shorthand for substitutions on the text of the previous 
line. Thus flbflib fixes the spelling of lib in the 
previous command. Finally, a history substitution may 
be surrounded with { and } if necessary to insulate it 
from the characters which follow. Thus, after Is —ld 
“paul we might do !{I}a to do Is—ld “paula, while !a 
would look for a command starting la. 


Quotations with ’ and ” 


The quotation of strings by ° and can be used to 
prevent all or some of the remaining substitutions. 
Strings enclosed in ° are prevented any further 
interpretation. Strings enclosed in may be expanded as 
described below. 


In both cases the resulting text becomes (all or part of) a 
single word; only in one special case (see Command 
Substitition below) does a quoted string yield parts of 
more than one word; * quoted strings never do. 


Alias substitution 


The shell maintains a list of aliases which can be 
established, displayed and modified by the alias and 
unaltas commands. After a command line is scanned, it 
is parsed into distinct commands and the first word of 
each command, left-to-right, is checked to see if it has 
an alias. If it does, then the text which is the alias for 
that command is reread with the history mechanism 
available as though that command were the previous 
input line. The resulting words replace the command 
and argument list. If no reference is made to the history 
list, then the argument list is left unchanged. 


Thus if the alias for Is is ls —] the command Is /usr 
would map to Is —1 /usr, the argument list here being 


<5 


CSH(1) 


Heo Similarly if the alias for lookup was grep 
fd ae) pase | then lookup bill would map to grep 
bl /etc/passwd 


If an alias is foil: the word transformation of the input 
text is performed and the aliasing process begins again 
on the reformed input line. Looping is prevented if the 
first word of the new text is the same as the old by 
flagging it to prevent further aliasing. Other loops are 
detected and cause an error. 


Note that the mechanism allows aliases to introduce 
parser metasyntax. Thus we can alias print “pr \!* | 
Ipr’ to make a command which pr’s its arguments to the 
line printer. 


Variable substitution 


The shell maintains a set of variables, each of which has 
as value a list of zero or more words. Some of these 
variables are set by the shell or referred to by it. For 
instance, the argv variable is an image of the shell’s 
argument list, and words of this variable’s value are 
referred to in special ways. 


The values of variables may be displayed and changed 
by using the set and unset commands. Of the variables 
referred to by the shell a number are toggles; the shell 
does not care what their value is, only whether they are 
set or not. For instance, the verbose variable is a toggle 
which causes command input to be echoed. The setting 
of this variable results from the —v command line 
option. 


Other operations treat variables numerically. The @ 
command permits numeric calculations to be performed 
and the result assigned to a variable. Variable values 
are, however, always represented as (zero or mere 
strings. For the purposes of numeric operations, the nul 
string is considered to be zero, and the second and 
subsequent words of multiword values are ignored. 


After the input line is aliased and parsed, and before 
each command is executed, variable substitution is 
performed keyed by $ characters. This expansion can be 
prevented by preceding the $ with a \ except within s 
where it always occurs, and within ‘s where it never 
occurs. Strings quoted by ~ are interpreted later (see 
Command substitution below) so $ substitution does not 
occur there until later, if at all. A $ is passed unchanged 
if followed by a blank, tab, or end-of-line. 


Input/output redirections are recognized before variable 
expansion, and are variable expanded _ separately. 
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Otherwise, the command name and entire argument list 
are expanded together. It is thus possible for the first 
(command) word to this point to generate more than one 
word, the first of which becomes the command name, 
and the rest of which become arguments. 


Unless enclosed in ” or given the :q modifier, the results 
of variable substitution may eventually be command and 
filename substituted. Within a variable whose value 
consists of multiple words expands to a (portion of) a 
single word, with the words of the variables value 
separated by blanks. When the :q modifier is applied to 
a substitution the variable will expand to multiple words 
with each word separated by a blank and quoted to 
prevent later command or filename substitution. 


The following metasequences are _ provided for 
introducing variable values into the shell input. Except 
as noted, it is an error to reference a variable which is 
not set. 


$name 

${name} 
Are replaced by the words of the value of variable 
name, each separated by a blank. Braces insulate 
name from following characters which would 
otherwise be part of it. Shell variables have names 
consisting of up to 20 letters and digits starting 
with a letter. The underscore character is 
considered a letter. 
If name is not a shell variable, but is set in the 
environment, then that value is returned (but : 
modifiers and the other forms given below are not 
available in this case). 


$name[selector| 

${name{selector] } 
May be used to select only some of the words from 
the value of name. The selector is subjected to ‘$’ 
substitution and may consist of a single number or 
two numbers separated by a —. The first word of a 
variables value is numbered 1. If the first number 
of a range is omitted it defaults to 1. If the last 
member of a range is omitted it defaults to 
$#name. The selector * selects all words. It is 
not an error for a range to be empty if the second 
argument is omitted or in range. 


$ name 


${#name} 


Gives the number of words in the variable. This is 
useful for later use in a ‘(selector]’. 
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$0 
Substitutes the name of the file from which 
command input is being read. An error occurs if 
the name is not known. 

$number 

${number} 
Equivalent to $argv{[number]. 

$x 


Equivalent to $argv[*]. 


The modifiers sh, :t, :r, :q, and :x may be applied to the 
substitutions above as may :gh, :gt, and :gr. If braces { 
} appear in the command form then the modifiers must 
appear within the braces. The current implementation 
allows only one : modifier on each $ expansion. 


The following substitutions may not be modified with : 
modifiers. 


$?name 
${?name} 
Substitutes the string 1 if name is set, O if it is not. 
$70 
Substitutes 1 if the current input filename is 
known, 0 if it is not. 
$$ 
Substitute the (decimal) process number of the 
(parent) shell. 
$< 


Substitutes a line from the standard input, with no 
further interpretation thereafter. It can be used to 
read from the keyboard in a shell script. 


Command and filename substitution 


The remaining substitutions, command and filename 
substitution, are applied selectively to the arguments of 
builtin commands. This means that portions of 
expressions which are not evaluated are not subjected to 
these expansions. For commands which are not internal 
to the shell, the command name is substituted separately 
from the argument list. This occurs very late, after 
input-output redirection is performed, and in a child of 
the main shell. 


Command substitution 


Command substitution is indicated by a command 
enclosed in *. The output from such a command is 
normally broken into separate words at blanks, tabs and 
newlines, with null words being discarded, this text then 
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replacing the original string. Within ”s, only newlines 
force new words; blanks and tabs are preserved. 


In any case, the single final newline does not force a new 
word. Note that it is thus possible for a command 
substitution to yield only part of a word, even if the 
command outputs a complete line. 


Filename substitution 


If a word contains any of the characters *, ?, |, or { or 
begins with the character ~, then that word is a 
candidate for filename substitution, also known as 
“globbing.” This word is then regarded as a pattern, and 
replaced with an alphabetically sorted list of file names 
which match the pattern. In a list of words specifying 
filename substitution it is an error for no pattern to 
match an existing file name, but it is not required for 
each pattern to match. Only the metacharacters *, ? 
and [ imply pattern matching, the characters ~, and 
being more akin to abbreviations. 


In matching filenames, the character . at the beginning 
of a filename or immediately following a /, as well as the 
character / must be matched explicitly. The character * 
matches any string of characters, including the null 
string. The character ? matches any single character. 
The sequence [...] matches any one of the characters 
enclosed. Within |...], a pair of characters separated by 
— matches any character lexically between the two. 


The character ~ at the beginning of a filename is used to 
refer to home directories. Standing alone, i.e., ~, it 
expands to the invokers home directory as reflected in 
the value of the variable home. When followed by a 
name consisting of letters, digits and ~ characters the 
shell searches for a user with that name and substitutes 
their home directory; thus “ken might expand to 
usr/ken and “ken/chmach to /usr/ken/chmach. 
f the character ~ is followed by a character other than a 
letter oy or appears not at the beginning of a word, it 
is left undisturbed. 


The metanotation a{b,c,d}e is a shorthand for abe ace 
ade . Left to right order is preserved, with results of 
matches being sorted separately at a low level to 
preserve this order. This construct may be nested. Thus 
“source/s1/ eee expands to 
/usr/source/s1/oldis.c /usr/source/s1/ls.c whether 
or not these files exist without any chance of error if the 
home directory for source is /usr/source. Similarly 
../{memo,*box} might expand to ../memo ../box 
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../mbox . (Note that memo was not sorted with the 
results of matching *box.) As a special case {,} and {} 
are passed undisturbed. 


Input /output 


The standard input and standard output of a command 
may be redirected with the following syntax: 


< name 
Open file name (which is first variable, command 
and filename expanded) as the standard input. 


<< word 

Read the shell input up to a line which is identical 
to word. Word is not subjected to variable, 
filename or command substitution, and each input 
line is compared to word before any substitutions 
are done on this input line. Unless a quoting \, , 
’, or ~ appears in word variable and command 
substitution is performed on the intervening lines, 
allowing \ to quote $, \, and *. Commands which 
are substituted have all blanks, tabs, and newlines 
preserved, except for the final newline which is 
dropped. The resultant text is placed in an 
anonymous temporary file which is given to the 
command as standard input. 


> name 

>! name 

>& name 

>&! name 
The file name is used as standard output. If the 
file does not exist then it is created; if the file 
exists, its is truncated, its previous contents being 
lost. 


If the variable noclobber is set, then the file must 
not exist or be a character special file (e.g., a 
terminal or /dev/null) or an error results. This 
helps prevent accidental destruction of files. In 
this case the ! forms can be used and suppress this 
check. 


The forms involving & route the diagnostic output 
into the specified file as well as the standard 
output. Name is expanded in the same way as < 
input filenames are. 


>> name 
>>& name 
>>! name 
>> &! name 
Uses file name as standard output like > but 
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places output at the end of the file. If the variable 
noclobber is set, then it is an error for the file not 
to exist unless one of the ! forms is given. 
Otherwise similar to >. 


A command receives the environment in which the shell 
was invoked as modified by the input-output parameters 
and the presence of the command in a pipeline. Thus, 
unlike some previous shelis, commands run from a file of 
shell commands have no access to the text of the 
commands by default; rather they receive the original 
standard input of the shell. The << mechanism should 
be used to present inline data. This permits shell 
command scripts to function as components of pipelines 
and allows the shell to block read its input. 


Diagnostic output may be directed through a pipe with 
the standard output. Simply use the form | & rather 
than just |. 


Expressions 


A number of the builtin commands (to be described 
subsequently) take expressions, in which the operators 
are similar to those of C, with the same precedence. 
These expressions appear in the @, eztt, tf, and while 
commands. The following operators are available: 


|] ee |t&—a=ke— yr <= 
<><< >> +-+4/%!17() 
Here the precedence increases to the right, ==, I=, 


=",and!", <=, >=, <, and >, <<, and >>, 4: 
and —, *, hi, and % being, in groups, at the same level. 


The ==, !==, =", and ! operators compare their 
arguments as strings; all others operate on numbers. 
The operators =" and 1" are like !== and == except 


that the right hand side is a pattern (containing, e.g., *’s, 
?’s and instances of [...]) against which the left hand 
operand is matched. This reduces the need for use of the 
switch statement in shell scripts when all that is really 
needed is pattern matching. 


Strings that begin with O are considered octal numbers. 
Null or missing arguments are considered 0. The result 
of al] expressions are strings, which represent decimal 
numbers. It is important to note that no two 
components of an expression can appear in the same 
word; except when adjacent to components of 
expressions which are syntactically significant to the 
parser (& |, <, >, (, )) they should be surrounded by 
spaces. 
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Also available in expressions as primitive operands are 
command executions enclosed in and } and file 
enquiries of the form —/name where | is one of: 


read access 
write access 
execute access 
existence 
ownership 
zero size 
plain file 
directory 


Banowx gs 


The specified name is command and filename expanded 
and then tested to see if it has the specified relationship 
to the real user. If the file does not exist or is 
inaccessible then all enquiries return false, i.e., 0. 
Command executions succeed, returning true, i.e., 1, if 
the command exits with status 0, otherwise they fail, 
returning false, ie., O. If more detailed status 
information is required then the command should be 
executed outside of an expression and the variable status 
examined. 


Control flow 


The shell contains a number of commands which can be 
used to regulate the flow of control in command files 
(shell scripts) and (in limited but useful ways) from 
terminal input. These commands all operate by forcing 
the shell to reread or skip in its input and, due to the 
implementation, restrict the placement of some of the 
commands. 


The foreach, swttch, and while statements, as well as the 
if-then-else form of the tf statement require that the 
major keywords appear in a single simple command on 
an input line as shown below. 

If the shell’s input is not seekable, the shell buffers up 
input whenever a loop is being read and performs seeks 
in this internal buffer to accomplish the rereading 
implied by the loop. (To the extent that this allows, 
backward goto’s will succeed on non-seekable inputs.) 
Builtin commands 

Builtin commands are executed within the shell. If a 
builtin command occurs as any component of a pipeline 
except the last, it is executed in a subshell. 
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alias 

alias name 

alias name wordlist 
The first form prints all aliases. The second form 
prints the alias for name. The final form assigns 
the specified wordlist as the alias of name; wordlist 
is command and filename substituted. Name is not 
allowed to be alias or unalias. 

break 
Causes execution to resume after the end of the 
nearest enclosing foreach or while. The remaining 
commands on the current line are executed. 
Multi-level breaks are thus possible by writing 
them all on one line. 


breaksw 
Causes a break from a swttch, resuming after the 
endsw. 


case label: 
A label in a switch statement as discussed below. 


cd 

ed name 

chdir 

chdir name 
Change the shells working directory to directory 
name. If no argument is given then change to the 
home directory of the user. 
If name is not found as a subdirectory of the 
current directory (and does not begin with /, ./ or 
.-/), then each component of the variable cdpath is 
checked to see if it has a subdirectory name. 
Finally, if all else fails but name is a shell variable 
whose value begins with /, then this is tried to see 
if it is a directory. 

continue 
Continue execution of the nearest enclosing while 
or foreach. The rest of the commands on the 
current line are executed. 


default: 
Labels the default case in a swttch statement. The 
default should come after all case labels. 

dirs 
Prints the directory stack; the top of the stack is at 
the left, the first directory in the stack being the 
current directory. 
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echo wordlist 

echo —n wordlist 
The specified words are written to the shells 
standard output, separated by spaces, and 
terminated with a newline unless the —n option is 
specified. Note that this differs from /bin/echo. 


else 

end 

endif 

endsw 
See the description of the foreach, tf, swttch, and 
while statements below. 


eval arg ... 

(As in sh(1).) The arguments are read as input to 
the shell and the resulting command(s) executed in 
the context of the current shell. This is usually 
used to execute commands generated as the result 
of command or variable substitution, since parsing 
occurs before these substitutions. See tset(1) for an 
example of using eval. 


exec command 
The specified command is executed in place of the 
current shell. 

exit 

exit(expr) 
The shell exits either with the value of the status 
variable (first form) or with the value of the 
specified expr (second form). 


foreach name (wordlist) 


end 
The variable name is successively set to each 
member of wordlist and the sequence of commands 
between this command and the matching end are 
executed. (Both foreach and end must appear 
alone on separate lines.) 


The builtin command continue may be used to 
continue the loop prematurely and the builtin 
command break to terminate it prematurely. 
When this command is read from the terminal, the 
loop is read up once prompting with ? before any 
statements in the loop are executed. If you make a 
mistake typing in a loop at the terminal you can 
rub it out. 


glob wordlist 
Like echo but no \ escapes are recognized and 
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words are delimited by null characters in the 
output. Useful for programs which wish to use the 
shell to filename expand a list of words. 


goto word 
The specified word is filename and command 
expanded to yield a string of the form ‘label’. The 
shell rewinds its input as much as possible and 
searches for a line of the form ‘label:’ possibly 
preceded by blanks or tabs. Execution continues 
after the specified line. 


history 

history n 

history —rn 
Displays the history event list; if n is given only 
the n most recent events are printed. The —r 
option reverses the order of printout to be most 
recent first rather than oldest first. 


if (expr) command 

If the specified expression evaluates true, then the 
single command with arguments is executed. 
Variable substitution on command happens early, 
at the same time it does for the rest of the 1 
command. Command must be a simple command, 
not a pipeline, a command list, or a parenthesized 
command list. Input/output redirection occurs 
even if ezpr is false, when command is not 
executed (this is a bug). 


if (expr) then 
else if (expr2) then 
else’ 


endif 
If the specified ezpr is true then the commands to 
the first else are executed; else if expr? is true then 
the commands to the second else are executed, etc. 
Any number of else-if pairs are possible; only one 
endtf is needed. The else part is likewise optional. 
(The words else and endif must appear at the 
beginning of input lines; the #f must appear alone 
on its input line or after an else.) 

jobs 

jobs —1 
Lists the active jobs; given the —1 options lists 
process id’s in addition to the normal information. 
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kill Zjob 
kill —sig %job ... 


kill pid 
kill —sig pid ... 
kill -1 


Sends either the TERM (terminate) signal or the 
specified signal to the specified jobs or processes. 
Signals are either given by number or by names (as 
given in /usr/include/stgnal.h, stripped of the 
prefix ‘“‘SIG”’). The signal names are listed by kill 
—-l. There is no default, saying just kill does not 
send a signal to the current job. 

limit 

limit resource 

limit resource mazimum-use 
Limits the consumption by the current process and 
each process it creates to not individually exceed 
mazimum-use on the specified resource. If no 
mazimum-use is given, then the current limit is 
printed; if no resource is given, then all limitations 
are given. 


Resources controllable currently include filestze 
(the largest single file which can be created). 


The mazimum-use may be given as a (floating 
point or integer) number followed by a scale factor. 
The default scale is ie or ‘kilobytes’ (1024 bytes); 
a scale factor of ‘m’ or ‘megabytes’ may also be 
used. 


For both resource names and _ scale factors, 
unambiguous prefixes of the names suffice. 


login 
Terminate a login shell, replacing it with an 
instance of /bin/login. This is one way to log off, 
included for compatibility with sh(1). 


logout 
Terminate a login shell. Especially useful if 
tgnorecof is set. 

nice 

nice +number 

nice command 

nice +number command 
The first form sets the ntce for this shell to 4. The 
second form sets the nice to the given number. 
The final two forms run command at priority 4 and 
number respectively. The super-user may specify 
negative niceness by using nice —number 
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Command is always executed in a sub-shell, and 
the restrictions place on commands in simple if 
statements apply. 


nohup 

nohup command 
The first form can be used in shell scripts to cause 
hangups to be ignored for the remainder of the 
script. The second form causes the specified 
command to be run with hangups ignored. All 
processes detached with & are effectively nohup’ed. 


notify 

notify %job ... 
Causes the shell to notify the user asynchronously 
when the status of the current or specified jobs 
changes; normally notification is presented before a 
prompt. This is automatic if the shell variable 
notify is set. 


onintr 

onintr - 

onintr label 
Control the action of the shell on interrupts. The 
first form restores the default action of the shell on 
interrupts which is to terminate shell scripts or to 
return to the terminal command input level. The 
second form onintr — causes all interrupts to be 
ignored. The final form causes the shell to execute 
a gotolabel when an interrupt is received or a child 
process terminates because it was interrupted. 


In any case, if the shell is running detached and 
interrupts are being ignored, all forms of ontnéir 
have no meaning and interrupts continue to be 
ignored by the shell and all invoked commands. 


popd 

popd +n 
Pops the directory stack, returning to the new top 
directory. With a argument ‘+n’ discards the nth 
entry in the stack. The elements of the directory 
stack are numbered from 0 starting at the top. 


pushd 

pushd name 

pushd +n 
With no arguments, pushd exchanges the top two 
elements of the directory stack. Given a name 
argument, pushd changes to the new directory (a la 
od} and pushes the old current working directory 
(as in ewd) onto the directory stack. With a 
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numeric argument, rotates the nth argument of 
the directory stack around to be the top element 
and changes to it. The members of the directory 
stack are numbered from the top starting at 0. 


rehash 

Causes the internal hash table of the contents of 
the directories in the path variable to be 
recomputed. This is needed if new commands are 
added to directories in the path while you are 
logged in. This should only be necessary if you 
add commands to one of your own directories, or if 
a systems programmer changes the contents of one 
of the system directories. 


repeat count command 
The specified command which is subject to the 
same restrictions as the command in the one line :f 
statement above, is executed count times. I/O 
redirections occur exactly once, even if count is 0. 


set 

set name 

set name—word 

set name|index|—word 

set name—(wordlist) 
The first form of the command shows the value of 
all shell variables. Variables which have other 
than a single word as value print as a 
parenthesized word list. The second form sets 
name to the null string. The third form sets name 
to the single word. The fourth form sets the 
indez’th component of name to _ word; this 
component must already exist. The final form sets 
name to the list of words in wordlist. In all cases 
the value is command and filename expanded. 


These arguments may be repeated to set multiple 
values in a single set command. Note however, 
that variable expansion happens for all arguments 
before any setting occurs. 


setenv name value 
Sets the value of environment variable name to be 
value, a single string. The most commonly used 
environment variables USER, TERM, PATH, and 
CDPATH are automatically imported to and 
exported from the csh variables user, term, path, 
and cdpath; there is no need to use setenv for these. 
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shift variable 


The members of argv are shifted to the left, 
discarding argv/1/. It is an error for argv not to be 
set or to have less than one word as value. The 
second form performs the same function on the 
specified variable. 


source name 


The shell reads commands from name. Source 
commands may be nested; if they are nested too 
deeply the shell may run out of file descriptors. An 
error in a source at any level terminates all nested 
source commands. 


switch (string) 
case str: 


breaksw 


default: 


breaksw 
endsw 


time 
time 


Each case label is successively matched, against the 
specified string which is first command and 
filename expanded. The file metacharacters *, ?, 
and |...) may be used in the case labels, which are 
variable expanded. If none of the labels match 
before a ‘default’ label is found, then the execution 
begins after the default label. Each case label and 
the default label must appear at the beginning of a 
line. The command breaksw causes execution to 
continue after the endsw. Otherwise control may 
fall through case labels and default labels as in C. 
If no label matches and there is no default, 
execution continues after the endsw. 


command 

With no argument, a summary of time used by this 
shell and its children is printed. If arguments are 
given the specified simple command is timed and a 
time summary as described under the time variable 
is printed. If necessary, an extra shell is created to 
print the time statistic when the command 
completes. 


ulimit —f n 


imposes a size limit of n. : 
—f imposes a size limit of n blocks on files written 
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by child processes (files of any size may be read). 
With no argument, the current limit is printed. 


umask 

umask value 
The file creation mask is displayed (first form) or 
set to the specified value (second form). The mask 
is given in octal. Common values for the mask are 
002 giving all access to the group and read and 
execute access to others or 022 giving all access 
except no write access for users in the group or 
others. 


unalias pattern 
All aliases whose names match the specified 
pattern are discarded. Thus all aliases are removed 
by ‘unalias *’. It is not an error for nothing to be 
unaliased. 


unhash 
Use of the internal hash table to speed location of 
executed programs is disabled. 


unset pattern 
All variables whose names match the specified 
pattern are removed. Thus all variables are 
removed by ‘unset *’; this has noticeably 
distasteful side-effects. It is not an error for 
nothing to be unset. 


unseteny pattern 
Removes all variables whose name match the 
specified pattern from the environment. See also 
the setenv command above and printenv(1). 

wait 
All background jobs are waited for. If the shell is 
interactive, then an interrupt can disrupt the wait, 
at which time the shell prints names and job 
numbers of all jobs known to be outstanding. 


while (expr) 


end 

While the specified expression evaluates non-zero, 
the commands between the whtle and the matching 
end are evaluated. Break and continue may be 
used to terminate or continue the loop 
prematurely. (The while and end must appear 
alone on their input lines.) Prompting occurs here 
the first time through the loop as for the foreach 
statement if the input is a terminal. 
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@ 

@ name = expr 

@ niagielindles| © expr 
The first form prints the values of all the shell 
variables. The second form sets the specified name 
to the value of expr. If the expression contains <, 
>, &, or |, then at least this part of the expression 
must be placed within ( ). The third form assigns 
the value of ezpr to the tndex’th argument of name. 
Both name and its tndex’th component must 
already exist. Beware of conflicts between the kill 
character and this use of @. 


The operators *==, +==, etc., are available as in 
C. The space separating the name from the 
assignment operator is optional. Spaces are, 
however, mandatory in separating components of 
expr which would otherwise be single words. 


Special postfix ++ and —— operators increment 
and decrement name respectively, i.e, @ i++. 


Pre-defined and environment variables 


The following variables have special meaning to the 
shell. Of these, argu, cwd, home, path, cdpath, prompt, 
shell and status are always set by the shell. Except for 
cwd and status this setting occurs only at initialization; 
these variables will not then be modified unless this is 
done explicitly by the user. 


This shell copies the environment variable USER into 
the variable user, TERM into term, and HOME into 
home, and copies these back into the environment 
whenever the normal shell variables are reset. The 
environment variable PATH is likewise handled; it is not 
necessary to worry about its setting other than in the file 
-eshre as inferior csh processes will import the definition 
of path from the environment, and re-export it if you 
then change it. 


argv Set to the arguments to the shell, it is 
from this variable that positional 
parameters are substituted, i.e., $1 is 
replaced by $argv([1], etc. 


cdpath Gives a list of alternate directories 
searched to find subdirectories in chdir 
commands. 

cwd The full pathname of the current 
directory. 
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Set when the —x command line option 
is given. Causes each command and its 
arguments to be echoed just before it is 
executed. For non-builtin commands 
all expansions occur before echoing. 
Builtin commands are echoed before 
command and filename substitution, 
since these substitutions are then done 
selectively. 


Can be given a string value to change 
the characters used in history 
substitution. The first character of its 
value is used as the history substitution 
character, replacing the default 
character !. The second character of its 
value replaces the character { in quick 
substitutions. 


Can be given a numeric value to control 
the size of the history list. Any 
command which has been referenced in 
this many events will not be discarded. 
Too large values of history may run the 
shell out of memory. The last executed 
command is always saved on the history 
list. 

The home directory of the invoker, 
initialized from the environment. The 
filename expansion of ~ refers to this 
variable. 


If set the shell ignores end-of-file from 
input devices which are terminals. This 
prevents shells from accidentally being 
killed by code-D’s. 


The files where the shell checks for 
mail. This is done after each command 
completion which will result in a 
prompt, if a specified interval has 
elapsed. The shell says ‘You have new 
mail.’ if the file exists with an access 
time not greater than its modify time. 


If the first word of the value of mail is 
numeric it specifies a different mail 
checking interval, in seconds, than the 
default, which is 10 minutes. 


If multiple mail files are specified, then 
the shell says ‘New mail in name’ when 
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there is mail in the file name. 


As described in the section on 
Input/output, restrictions are placed on 
output redirection to insure that files 
are not accidentally destroyed, and that 
>> redirections refer to existing files. 


If set, filename expansion is inhibited. 
This is most useful in shell scripts 
which are not dealing with filenames, or 
after a list of filenames has been 
obtained and further expansions are not 
desirable. 


If set, it is not an error for a filename 
expansion to not match any existing 
files; rather the primitive pattern is 
returned. It is still an error for the 
primitive pattern to be malformed, i.e., 
echo [ still gives an error. 


If set, the shell notifies asynchronously 
of job completions. The default is to 
rather present job completions just 
before printing a prompt. 


Each word of the path variable specifies 
a directory in which commands are to 
be sought for execution. A null word 
specifies the current directory. If there 
is no path variable then only full path 
names will execute. The usual search 
path is ., /bin, and /usr/bin, but this 
may vary from system to system. For 
the super-user the default search path is 
/ete, /bin, and /usr/bin. A shell 
which 1s given neither the —e nor the 
—t option will normally hash the 
contents of the directories in the path 
variable after reading .cshre, and each 
time the path variable is reset. If new 
commands are added to _ these 
directories while the shell is active, it 
may be necessary to give the rehash or 
the commands may not be found. 


The string which is printed before each 
command is read from an interactive 
terminal input. If a ! appears in the 
string it will be replaced by the current 
event number unless a preceding \ is 
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given. Default is %, or # for the 
super-user. 


shell The file in which the shell object code 
resides. This is used in forking shells to 
interpret files which have execute bits 
set, but which are not executable by the 
system. (See the description of Non- 
builtin Command Execution below. 
Initialized to the (system-dependent 
home of the shell. 


status The status returned by the last 
command. If it terminated abnormally, 
then 0200 is added to the status. 
Builtin commands which fail return exit 
status 1, all other builtin commands set 
status O. 


time Controls automatic timing of 
commands. If set, then any command 
which takes more than this many cpu 
seconds will cause a line giving user, 
system, and real times and a utilization 
percentage which is the ratio of user 
plus system times to real time to be 
printed when it terminates. 


verbose Set by the —v command line option, 
causes the words of each command to 
be printed after history substitution. 


Non-builtin command execution 


When a command to be executed is found to not be a 
builtin command, the shell attempts to execute the 
command via ezecv(2). Each word in the variable path 
names a directory from which the shell will attempt to 
execute the command. If it is given neither a ~c nor a 
—t option, the shell will hash the names in these 
directories into an internal table so that it will only try 
an ezec in a directory if there is a possibility that the 
command resides there. This greatly speeds command 
location when a large number of directories are present 
in the search path. If this mechanism has been turned 
off (via unhash), or if the shell was given a —e or —t 
argument, and in any case for each directory component 
of path which does not begin with a /, the shell 
concatenates with the given command name to form a 
path name of a file which it then attempts to execute. 


Parenthesized commands are always executed in a 
subshell. Thus (ed ; pwd) ; pwd prints the home 
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directory; leaving you where you were (printing this after 
the home directory), while ed ; pwd leaves you in the 
home directory. Parenthesized commands are most often 
used to prevent chdtr from affecting the current shell. 


If the file has execute permissions but is not an 
executable binary to the system, then it is assumed to be 
a file containing shell commands and a new shell is 
spawned to read it. 

If there is an altas for shell then the words of the alias 
will be prepended to the argument list to form the shell 
command. The first word of the alias should be the full 
path name of the shell (e.g., $shell). Note that this is a 
special, late occurring, case of altas substitution, and 
only allows words to be prepended to the argument list 
without modification. 


Argument list processing 


If argument 0 to the shell is — then this is a login shell. 
The flag arguments are interpreted as follows: 


-ce Commands are read from the (single) following 
argument which must be present. Any remaining 
arguments are placed in argv. 


~e The shell exits if any invoked command terminates 
abnormally or yields a non-zero exit status. 


—f The shell will start faster, because it will neither 
search for nor execute commands from the file 
-cshre in the invoker’s home directory. 


-i The shell is interactive and prompts for its top- 
level input, even if it appears to not be a terminal. 
Shells are interactive without this option if their 
inputs and outputs are terminals. 


—n Commands are parsed, but not executed. This aids 
in syntactic checking of shell scripts. 

—s Command input is taken from the standard input. 

—t A single line of input is read and executed. A 


may be used to escape the newline at the end o 
this line and continue onto another line. 


~v Causes the verbose variable to be set, with the 
effect that command input is echoed after history 
substitution. 


-x Causes the echo variable to be set, so that 
commands are echoed immediately before 
execution. 
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—V Causes the verbose variable to be set even before 
-cshre is executed. 


—-X Is to —x as —V is to -v. 


After processing of flag arguments if arguments remain 
but none of the —c, —i, —s, or —t options was given the 
first argument is taken as the name of a file of 
commands to be executed. The shell opens this file, and 
saves its name for possible resubstitution by $0. Since 
many systems use either the standard version 6 or 
version 7 shells whose shell scripts are not compatible 
with this shell, the shell will execute such a “standard” 
shell if the first character of a script is not a #, ie., if 
the script does not start with a comment. Remaining 
arguments initialize the variable argv. 


Signal handling 


The shell normally ignores quit signals. Jobs running 
detached (by the & command) are immune to signals 
generated from the keyboard, including hangups. Other 
signals have the values which the shell inherited from its 
parent. The shells handling of interrupts and terminate 
signals in shell scripts can be controlled by ontntr. Login 
shells catch the terminate signal; otherwise this signal is 
passed on to children from the state in the shell’s parent. 
In no case are interrupts allowed when a login shell is 
reading the file logout. 


AUTHOR 


William Joy. Job control and directory stack features 
first implemented by J.E. Kulp of L.1.A.S.A, Laxenburg, 
Austria, with different syntax than that used now. 


FILES 
/etc/cprofile Read by the login shell before .cshre. 
~/.eshre Read at beginning of execution by each 
shell. 
~/ login Read by login shell, after .cshre at 
login. 
~/ logout Read by login shell, at logout. 
/bin/sh Standard shell, for shell scripts not 
starting with a #. 
/tmp/sh* Temporary file for <<<. 
/etc/passwd Source of home directories for “name. 
LIMITATIONS 


Words can be no longer than 1024 characters. The 
system limits argument lists to 10240 characters. The 
number of arguments to a command which involves 
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filename expansion is limited to 1/6’th the number of 
characters allowed in an argument list. Command 
substitutions may substitute no more characters than are 
allowed in an argument list. To detect looping, the shell 
restricts the number of alias substitutions on a single line 
to 20. 


SEE ALSO 


NOTES 


BUGS 


sh(1), shl(1), access(2), fork(2), pipe(2), umask(2), 
wait(2), a.out(5). 


Csh may not be compatible with some shell commands, 
such as at(1), newgrp(1), and wm(1). 

If the first character in an executable file is #, the file is 
interpreted as a csh script. Because # is interpreted as a 
comment delimiter by sh, it is recommended that sh 
scripts begin with a blank line. 


Alias substitution is most often used to clumsily simulate 
shell procedures; shell procedures should be provided 
rather than aliases. 


Commands within loops, prompted for by ?, are not 
placed in the hrstory list. Cshk should parse the control 
structure rather recognizing built-in commands. This 
would allow control commands to be placed anywhere, to 
be combined with |, and to be used with & and ; 
metasyntax. 


It should be possible to use the : modifiers on the output 
of command substitutions. All and more than one : 
modifier should be allowed on $ substitutions. 
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NAME 


CSPLIT(1) 


esplit — context split 


SYNOPSIS 


esplit (~s] (—k] (-f prefix] file argi [... 


DESCRIPTION 
Csplit reads file and separates it into n+1 sections, 
defined by the arguments argl... argn. By defauit 
the sections are placed in xx00 ... xxn (n may not be 
greater than 99). These sections get the following pieces 


of file: 


argn| 


00: From the start of file up to (but not 
including) the line referenced by arg1. 
01: From the line referenced by arg1 up to the 


line referenced by arg2. 


n+l: From the line referenced by argn to the 


end of file. 


If the file argument is a —, then standard input is used. 


The options to csplit are: 


-8 Csplit normally prints the character 
counts for each file created. If the —s 
option is present, csplit suppresses the 
printing of all character counts. 


—k Csplit normally removes created files if 
an error occurs. If the —k option is 
present, csplit leaves previously created 


files intact. 


—f prefiz If the —f option is used, the created 
files are named prefirOO ... preftrn. 


The default isxx00 ... 


xxn. 


The arguments (argl ... argn) to csplit can be a 


combination of the following: 


/rezp/ <A file is to be created for the section 
from the current line up to (but not 
including) the line containing the regular 


expression rezp. The 


current line 


becomes the line containing rezp. This 
argument may be followed by an 
optional + or — some number of lines 


(e.g., /Page/—5). 
%rexp% 


This argument is the same as /rezp/, 
except that no file is created for the 


section. 


ee 
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NAME 

grep, egrep, fgrep — search a file for a pattern 
SYNOPSIS 

grep [ options | expression | files | 

egrep [ options | { expression | | files | 

fgrep [ options | { strings ] [ files ] 
DESCRIPTION 


Commands of the grep family search the input files 
(standard input default) for lines matching a pattern. 
Normally, each line found is copied to the standard 
output. Grep patterns are limited regular ezpressions in 
the style of ed(1); it uses a compact non-deterministic 
algorithm. Egrep patterns are full regular expressions; it 
uses a fast deterministic algorithm that sometimes needs 
exponential space. Fgrep patterns are fixed strings; it is 
fast and compact. The following options are recognized: 


-v__ All lines but those matching are printed. 
-x (Exact ny lines matched in their entirety are 
paste (fgrep only). 


-ce Only acount of Wy) ie lines is printed. 
-i Ignore upper/lower case distinction during 
comparisons. 


-l Only the names of files with matching lines are 
listed (once), separated by new-lines. 

—n Each line is preceded by its relative line number 
in the file. 

-b Each line is preceded by the block number on 
which it was found. This is sometimes useful in 
locating disk block numbers by context. 

-8 The error messages produced for nonexistent or 
unreadable files are suppressed (grep only). 

—e expression 
Same as a simple expression argument, but useful 
when the ezpresston begins with a — (does not 
work with grep). 

-f file 
The regular ezpression (egrep) or strings list 
(fgrep) is taken from the file. 


In all cases, the file name is output if there is more than 
one input file. Care should be taken when using the 
characters $, *, [, *, |, | ), and \ in expression, because 
they are also ‘meaning ul to the shell. It is safest to 
enclose the entire ezpresston argument in single quotes 


Fgrep searches for lines that contain one of the strings 
separated by new-lines. 
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and \), with the addition of: 


A regular expression followed by + matches one 
or more occurrences of the regular expression. 


‘Ce accepts regular expressions as in ed(1), except for 
\ 
1. 


2. A regular expression followed by ? matches 0 or 1 
occurrences of the regular expression. 

3. Two regular expressions separated by | or by a 
new-line match strings that are matched by 
either. 

4. A regular expression may be_ enclosed in 


parentheses ( ) for grouping. 


The order of precedence of operators is [], then * ? +, 
then concatenation, then | and new-line. 


SEE ALSO 


ed(1), sed(1), sh(1). 


DIAGNOSTICS 


BUGS 


Exit status is 0 if any matches are found, 1 if none, 2 for 
syntax errors or inaccessible files (even if matches were 
found). 


Ideally there should be only one grep, but we do not 
know a single algorithm that spans a wide enough range 
of space-time tradeoffs. 

Lines are limited to BUFSIZ characters; longer lines are 
truncated. BUFSIZ is defined in 
/usr/include/stdio.h.) 

Egrep does not recognize ranges, such as [a—z], in 
character classes. 

If there is a line with embedded nulls, grep will only 
match up to the first null; if it matches, it will print the 
entire line. 


NAME 


GUTIL(1G) 


gutil — graphical utilities 


SYNOPSIS 


command-name [options] [files] 


DESCRIPTION 


Below is a list of miscellaneous device independent 
utility commands found in /usr/bin/graf. If no files 
are given, input is from the standard input. All output 
is to the standard output. Graphical data is stored in 
GPS format; see gps(4). 


bel 
cevrtopt 


gd 


gtop 


— send bel character to terminal 
[=sstring fetring istring tstring | [args | 
— options converter 
Cvrtopt reformats args (usually the command 
line arguments of a calling shell procedure) to 
facilitate processing by shell procedures. An 
arg is either a file name (a string not 
beginning with a —, or a — by itself) or an 
option string (a string of options beginning 
with a —). Output is of the form: 

—option —option. .. file name(s) 
All options appear singularly and preceding 
any file names. Options that take values 
(e.g., —r1.1) or are two-letters long must be 
described through options to curtopt. 


Curtopt is usually used with set in the 
following manner as the first line of a shell 
procedure: 

set — ‘cvrtopt =[options] $@* 
Options to cvrtopt are: 
sstring String accepts string values. 
fstring String accepts floating point 

numbers as values. 

istring String accepts integers as values. 


tstring String is a two-letter option name 
that takes no value. 


String is a one- or two-letter option name. 

[ GPS files ‘ ~ GPS dump 

Gd prints a human readable listing of GPS. 
ee u__]| [GPS files ] — GPS to plot(4) 
ilter 

Gtop transforms a GPS into _ plot(4) 


pd 
ptog 
quit 


remcom 


whatis 


yoo 


SEE ALSO 
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commands displayable by plot filters. GPS 
objects are translated if they fall within the 
window that circumscribes the first file unless 
an option is given. 


Options: 
rn translate objects in GPS region n. 
u translate all objects in the GPS 


universe. 


[plette) files | - ne dump 
d prints a human readable listing of plot(4) 
format graphical commands. 


ferett) ) files | — plot(4) to GPS filter 
tog transforms plot(4) commands into a 
GPS. 


— terminate session 


files | — remove comments 

emcom copies its input to its output with 
comments removed. Comments are as 
defined in C (i.e., /* comment */). 


{[-o |] [ names |] -—- brief on-line 
documentation 

Whatis prints a brief description of each 
name given. If no name is given, then the 
current list of description names is printed. 
The command whatis \* prints out every 
description. 

Option: 

o just print command options 

file — pipe fitting 

Yoo is a piping primitive that deposits the 
output of a pipeline into a file used in the 
pipeline. Note that, without yoo, this is not 
usually successful as it causes a read and 
write on the same file simultaneously. 


graphics(1G), gps(4), plot(4). 
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NAME 
hd — hexadecimal and ascii file dump 


SYNOPSIS 
/usr/local/bin/hd file 
DESCRIPTION 
Hid prints a hexadecimal listing of file, side by side with 
an ASCII listing. 
SEE ALSO 
od(1). : 
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NAME 

head — give first few lines 
SYNOPSIS 

head { —count | [| file ... ] 
DESCRIPTION 


Head gives the first count lines of each of the specified 
files. If no files are specified, head reads the standard 
input. If you omit count, head prints the first 10 lines. 


SEE ALSO 
tail(1). 
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NAME 

help — ask for help 
SYNOPSIS 

help [args] 
DESCRIPTION 


Help finds information to explain a message from a 
command or explain the use of a command. Zero or 
more arguments may be supplied. If no arguments are 
given, help will prompt for one. 


The arguments may be either message numbers (which 

normally appear in parentheses following messages) or 

command names, of one of the following types: 

type I Begins with non-numerics, ends in numerics. 
The non-numeric prefix is usually an 
abbreviation for the program or set of 
routines which produced the message (e.g., 
ge6, for message 6 from the get command). 

type 2 Does not contain numerics (as a command, 
such as get) 


type 3 Is all numeric (e.g., 212) 


The response of the program will be the explanatory 
information related to the argument, if there is any. 


When all else fails, try “‘help stuck’’. 


FILES 
/usr/lib/help directory containing files of 
message text. 
/usr/lib/help /helploc file containing locations of 
help files not in 
/usr/lib/help. 
DIAGNOSTICS 


Use help(1) for explanations. 
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NAME 
hinv — hardware inventory 


SYNOPSIS 
/etc/hinv option 
/etc/hinv hardware-item 
DESCRIPTION 


Hinv provides hardware configuration information. It is 
used in one of two ways. For the first way, an option is 
given and the result is printed on stdout. The other way 
involves asking about a particular hardware item and 


hinv existing with 1 if it exists and 0 otherwise. 
Option is one of the following: 


—p Print hardware configuration. Items are 
printed one per line. 

~—¢e Print CPU type. 

~f Print FPU type. 

-8 Print system type. 

—u Print maximum number of users. 

-m Print total physical memory in bytes. 


Hardware-item is one of the following: 

88881 68881 floating-point processor. 

iop Terminal accelerator board. 

422 Any RS-422 cluster board. 

422-2 Two-channel RS-422 cluster board. 
422-4 Four-channel RS-422 cluster board. 


vme VME interface board. 

sn RS-232 board n. 

serial Gives number of serial ports present. 
disks Gives number of disks present. 
eeprom VME EEPROM valid for UNIX. 


BUGS 
Hinv does not know about VME cards. 
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NAME 
hp — handle special functions of HP 2640 and 2621-series 
terminals 

SYNOPSIS 
hp | -e}] [-m] 

DESCRIPTION 


Hp supports special functions of the Hewlett-Packard 
2640 series of terminals, with the primary purpose of 
producing accurate representations of most nroff output. 
A typical use is: 


nroff —h files ... | hp 


Regardless of the hardware options on your terminal, Ap 
tries to do sensible things with underlining and reverse 
line-feeds. If the terminal has the ‘display 
enhancements” feature, subscripts and superscripts can 
be indicated in distinct ways. If it has the 
‘“‘mathematical-symbol” feature, Greek and other special 
characters can be displayed. 


The flags are as follows: 

—-e It is assumed that your terminal has the 
‘display enhancements” feature, and so maximal 
use is made of the added display modes. 
Overstruck characters are presented in the 
Underline mode. Superscripts are shown in 
Half-bright mode, and subscripts in Half-bright, 
Underlined mode. If this flag is omitted, hp 
assumes that your terminal lacks the “display 
enhancements” feature. In this case, all 
overstruck characters, subscripts, and 
superscripts are displayed in Inverse Video mode, 
i.e., dark-on-light, rather than the usual light- 
on-dark. 

~-m Requests minimization of output by removal of 
new-lines. Any contiguous sequence of 3 or more 
new-lines is converted into a sequence of only 2 
new-lines; i.e., any number of successive blank 
lines produces only a single blank output line. 
This allows you to retain more actual text on the 
screen. 


With regard to Greek and other special characters, Ap 
provides the same set as does 900(1), except that “not” 
is approximated by a right arrow, and only the top half 
of the integral sign is shown. The display is adequate for 
examining output from negn. 


DIAGNOSTICS 
“line too long” if the representation of a line exceeds 


sf 


HP (1) 


1,024 characters. 
The exit codes are O for normal termination, 2 for all 
errors. 


SEE ALSO 


BUGS 


300(1), col(1), eqn(1), greek(1), nroff(1), tbl(1). 


An “overstriking sequence” is defined as a printing 
character followed by a backspace foliowed by another 
printing character. In such sequences, if either printing 
character is an underscore, the other printing character 
is shown underlined or in Inverse Video; otherwise, only 
the first printing character is shown (again, underlined or 
in Inverse Video). Nothing special is done if a backspace 
is adjacent to an ASCII control character. Sequences of 
control characters (e.g., reverse line-feeds, backspaces) 
can make text “disappear”; in particular, tables 
generated by ¢bl(1) that contain vertical lines will often 
be missing the lines of text that contain the “foot” of a 
aay line, unless the input to hp is piped through 
col{1). 

Although some terminals do provide numerical 
superscript characters, no attempt is made to display 
them. 
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NAME 

hyphen — find hyphenated words 
SYNOPSIS 

hyphen [| files ] 
DESCRIPTION 


Hyphen finds all the hyphenated words ending lines in 
files and prints them on the standard output. If no 
arguments are given, the standard input is used; thus, 
hyphen may be used as a filter. 


EXAMPLE 
The following will allow the proofreading of nroff 
hyphenation in teztfile. 


mm textfile | hyphen 


SEE ALSO 
mm(1), nroff(1). 

BUGS 
Hyphen cannot cope with hyphenated .ttalic (i.e., 
underlined) words; it will often miss them completely, or 
mangle them. 
Hyphen occasionally gets confused, but with no ill effects 
other than spurious extra output. 
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NAME 
id — print user and group IDs and names 
SYNOPSIS 
id 
DESCRIPTION 
Id writes a message on the standard output giving the 
user and group IDs and the corresponding names of the 


invoking process. If the effective and real IDs do not 
match, both are printed. 


SEE ALSO 
logname(1), getuid(2). 


NAME 


IFCONFIG(1NM) 


ifconfig — configure network interface parameters 


SYNOPSIS 


/ete/ifconfig interface { address ] [ parameters | 


DESCRIPTION 


Ifeonfig is used to assign an address to a network 
interface and/or configure network interface parameters. 
Ifconfig must be used at boot time to define the network 
address of each interface present on a machine; it may 
also be used at a later time to redefine an interface’s 
address. The tnterface parameter is a string of the form 
“name unit’’, e.g. ‘‘enO”’, while the address is either a 
host name present in the host name data base, hosts(4), 
or a DARPA Internet address expressed in the Internet 
standard “dot notation’. 


The following parameters may be set with ifconfig: 
up Mark an interface “‘up’’. 


down Mark an interface “down”. When an 
interface is marked ‘‘down’’, the system 
will not attempt to transmit messages 
through that interface. 


trailers Enable the use of a ‘‘trailer’’ link level 
encapsulation when sending (default). 
If a network interface supports trailers, 
the system will, when possible, 
encapsulate outgoing messages in a 
manner which minimizes the number of 
memory to memory copy operations 
performed by the receiver. 


—trailers Disable the use of a “trailer” link level 
encapsulation. 
arp Enable the use of the Address 


Resolution Protocol in mapping 
between network level addresses and 
link level addresses (default). This is 
currently implemented for mapping 
between DARPA Internet addreses and 
10Mb/s Ethernet addresses. 


—arp Disable the use of the Address 
Resolution Protocol. 

Ifeonfig displays the current configuration for a network 

interface when no optional parameters are supplied. 


Only the super-user may modify the configuration of a 
network interface. 
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DIAGNOSTICS 
Messages indicating the specified interface does not exit, 
the requested address is unknown, the user is not 
privileged and tried to alter an interface’s configuration. 


SEE ALSO 
intro(4N), netstat(1). 
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NAME 
includes — determine C language preprocessor include 
files 

SYNOPSIS 
includes [ option ... ] file ... 

DESCRIPTION 


Includes determines the #include files necessary to 
compile a C language source file using the C language 
preprocessor cpp(1). Includes is based on cpp(1) and 
takes the same options. Multiple source files may be 
named on the command line. However, instead of 
producing preprocessed code, it produces on standard 
output a list of the #include file dependencies (directly 
or nested) of the named source files. 


The output format is suitable for direct use in a makefile 
to be used by the make(1) command. For each named 
source file, the #finclude files are listed, one per line, 
preceded by the name of the source file (with the last 
letter of its name changed to the letter ’o’). The two 
names are separated by the two characters ": ”. For 
example, if source file pgm.c depends only on the 
#include file incl.h, then the output of includes for 
the source file pgm.c would be: 
pgm.o: incl.h 


The following options to includes are recognized: 
-P This option has no affect. 
-C This option has no affect. 


—Uname 
Remove any initial definition of name, where 
name is a reserved symbol that is predefined by 
the particular preprocessor. The current list of 
these possibly reserved symbols includes: 
operating system: ibm, gcos, os, tss, unix 
hardware: interdata, pdp11, u370, 
u3b, vax, mc68k, 
mc68000, mc68010, 
mc68020 
system variants: RES, RT 


—Dname 

—Dname=def 
Define name as if by a #define directive. If no 
= def is given, name is defined as 1. 


-Idir Change the algorithm for searching for 
#include files whose names do not begin with / 
to look in dir before looking in the directories on 
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the standard list. Thus, #include files whose 
names are enclosed in ” ” will be searched for 
first in the directory of the tfile argument, then 
in directories named in —I options, and last in 
directories on a standard list. For #include 
files whose names are enclosed in <>, the 
directory of the tftle argument is not searched. 


Two special names are understood by includes. The 
name __LINE__ is defined as the current line number 
(as a decimal integer) as known by includes, and 
___FILE___ is defined as the current file name (as a C 
string) as known by tncludes. They can be used 
anywhere (including in macros) just as any other defined 
name. 


All cpp directives understood by tncludes start with lines 
begun by #. The directives are: 


#define name token-string 
Replace subsequent instances of name 
with token-string. 


#define name( arg, ..., arg ) token-string 

Notice that there can be no space 
between name and the (. Replace 
subsequent instances of name followed 
by a (, a list of comma separated 
tokens, and a ) by token-string where 
each occurrence of an arg in the token- 
string is replaced by the corresponding 
token in the comma separated list. 


#tundef name Cause the definition of name (if any) to 
be forgotten from now on. 


#include " filename” 

#include <filename > 
Include at this point the contents of 
filename (which will then be run 
through includes). When the 
<filename > notation is used, filename 
is only searched for in the standard 
places. See the —I option above for 
more detail. 


#line integer-constant " filename” 
This directive has no affect. 

#endif 
Ends a section of lines begun by a test 
directive (#if, #ifdef, or #ifndef). 
Each test directive must have a 
matching #endif. 
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#ifdef name The lines following will be processed if 
and only if name has been the subject 
of a previous #define without being 
the subject of an intervening #undef. 


#ifndef name The lines following will not be 
processed if and only if name has been 
the subject of a previous #define 
without being the subject of an 
intervening #undef. 


#if constant-expression 

Lines following will be processed if and 
only if the constant-expression 
evaluates to non-zero. All binary non- 
assignment C operators, the ?: operator, 
the unary —, !, and ~ operators are all 
legal in constant-expression. The 
precedence of the operators is the same 
as defined by the C language. There is 
also a unary operator defined, which 
can be used in constant-expression in 
these two forms: defined ( name ) or 
defined name. This allows the utility 
of #ifdef and #ifndef in a #if 
directive. Only these operators, integer 
constants, and names which are known 
by includes should be used in constant- 
ezpression. In particular, the sizeof 
operator is not available. 


ffelse Reverses the notion of the test directive 
which matches this directive. So if lines 
previous to this directive are ignored, 
the following lines will be processed. 
And vice versa. 


The test directives and the possible #else directives can 


be nested. 
FILES 

/usr/include standard directory for #include files 
SEE ALSO 

ce(1), epp(t), m4(t). 
DIAGNOSTICS 


The error messages produced by tncludes are intended to 
be self-explanatory. The lne number and filename 
where the error occurred are printed along with the 
diagnostic. 


NAME 
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init, telinit — process control initialization 


SYNOPSIS 


/etc/init {[0123456SsQq | 
/etc/telinit | 0123456sSQqabc | 


DESCRIPTION 


Init 


Init is a general process spawner. Its primary role is to 
create processes from a script stored in the file 
/ete/inittab (see intttab(4)). This file usually has intt 
spawn getty’s on each line that a user may log in on. It 
also controls autonomous processes required by any 
particular system. 


Init considers the system to be in a run-level at any 
given time. A run-level can be viewed as a software 
configuration of the system where each configuration 
allows only a selected group of processes to exist. The 
processes spawned by init for each of these run-levels is 
defined in the tntttad file. Intt can be in one of eight 
run-levels, O~6 and S or s. The run-level is changed by 
having a privileged user run /etc/init (which is linked 
to /ete felinit) This user-spawned intt sends 
appropriate signals to the original intt spawned by the 
operating system when the system was rebooted, telling 
it which run-level to change to. 


Init is invoked inside the CTIX system as the last step in 
the boot process. The first thing init does is to look for 
/etc/inittab and see if there is an entry of the type 
initdefault (see inittab(4)). If there is, init uses the run- 
level specified in that entry as the initial run-level to 
enter. If this entry is not in tntttab or tnittab is not 
found, tntt requests that the user enter a run-level from 
the virtual system console. If an S (s) is entered, init 
goes into the SINGLE USER level. This is the only run- 
level that does not require the existence of a properly 
formatted inittab file. If /ete/inittab does not exist, 
then by default the only legal run-level that tntt can 
enter is the SINGLE USER level. In the SINGLE USER 
level the virtual console terminal /dev/syscon is 
opened for reading and writing and the command 
bin/su is invoked immediately. To exit from the 
SINGLE USER run-level one of two options can be 
elected. First, if the shell is terminated (via an end-of- 
file), intt will reprompt for a new run-level. Second, the 
init or telintt command can signal tntt and force it to 
change the run-level of the system. Intt always trys to 
relink /dev/syscon to a reasonable terminal before 
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opening it. It invokes conlocate(1M) to do this. 


When intt prompts for the new run-level, the operator 
may enter only one of the digits O through 6 or the 
letters S or s. If S is entered intt operates as previously 
described in SINGLE USER mode with the additional 
result that /dev/syscon is linked to the user’s terminal 
line, thus making it the virtual system console. A 
message is generated on the previous system console, 
saying where the virtual terminal has been relocated. 


When tntt comes up initially and whenever it switches 
out of SINGLE USER state to normal run states, it sets 
the toctl(2) states of the virtual console, / ae evacon, 
to those modes saved in the file /etc/ioctl.syscon. 
This file is written by tnt¢é whenever SINGLE USER mode 
is entered. If this file does not exist when tntt wants to 
read it, a warning is printed and default settings are 
assumed. 


If a O through 8 is entered tntt enters the corresponding 
run-level, Any other input will be rejected and the user 
will be re-prompted. If this is the first time init has 
entered a run-level other than SINGLE USER, init first 
scans tntttab for special entries of the type boot and 
bootwatt. These entries are performed, providing the 
run-level entered matches that of the entry before any 
normal processing of intttab takes place. In this way any 
special initialization of the operating system, such as 
mounting file systems, can take place before users are 
allowed onto the system. The tn:ttad file is scanned to 
find all entries that are to be processed for that run- 
level. 


Run-level 2 is usually defined by the user to contain all 
of the terminal processes and daemons that are spawned 
in the multi-user environment. 


In a multi-user environment, the tntttadb file is usually set 
up so that mrt will create a process for each terminal on 
the system. 


For terminal processes, ultimately the shell will 
terminate because of an end-of-file either typed explicitly 
or generated as the result of hanging up. When init 
receives a child death signal, telling it that a process it 
spawned has died, it records the fact and the reason it 
died in /etc/utmp and if it exists (see who(1)). A 
history of the processes spawned is kept in /ete/wtmp 
if such a file exists. 


To spawn each process in the tntttab file, tntt reads each 
entry and for each entry which should be respawned, it 
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forks a child process. After it has spawned all of the 
processes specified by the insttad file, intt waits for one 
of its descendant processes to die, a powerfail signal, or 
until intt is signaled by inst or telintt to change the 
system’s run-level, When one of the above three 
conditions occurs, intt re-examines the tnittad file. New 
entries can be added to the insttab file at any time; 
however, inté still waits for one of the above three 
conditions to occur. To provide for an instantaneous 
response the init Q or init q command can wake init to 
re-examine the inittad file. 


If init receives a powerfasl signal (SJGPWR) and is not in 
SINGLE USER mode, it scans intttab for special powerfail 
entries. These entries are invoked (if the run-levels 
permit) before any further processing takes place. In this 
way intt can perform various cleanup and recording 
functions whenever the operating system experiences a 
power failure. It is important to note that the powerfail 
entries should not use devices that must first be 
initialized after a power failure has occurred. 


When init is requested to change run-levels (via telinit), 
init sends the warning signal (SIGTERM) to all 
processes that are undefined in the target run-level. Init 
waits 20 seconds before forcibly terminating these 
processes via the kill signal (SIGKILL). 
Telinit 

Telintt, which is linked to /etc/intt, is used to direct the 
actions of itt. It takes a one-character argument and 
signals tntt via the kill system call to perform the 
appropriate action. The following arguments serve as 
directives to init. 


0-6 tells intt to place the system in one of 
the run-levels O—6. 
a,b,c tells intt to process only those 


/etc/inittab file entries having the a, 
borc run-level set. 


Q,4 tells init to re-examine’ the 
/etc/inittab file. 
3,8 tells intt to enter the single user 


environment. When this level change 
is effected, the virtual system teletype, 
/dev/syscon, is changed to the 
terminal from which the command 
was executed. 


A directive to change to run-level 6 receives 
special priority. Ordinarily, a run-level change 


<3. 


FILES 


INIT (1M) 


received while init is re-examining tntttab does 
not take effect until the re-examination is 
complete. But a directive to change to run-level 
6 received while tntt is waiting on a bootwatt 
entry is effected as soon as the command in the 
bootwatt entry finishes. This special case 
permits a bootwatt command to use telintt to 
stop the system initialization process before users 
get access to the system. Run-level 6 then 
handles the transition to single-user state: see 


/ete/ profile. 
Telinit can only be run by someone who is super-user or 
a member of group sys. 


/etc/inittab 
/etc/utmp 
/etc/wtmp 

/etc /ioctl.syscon 
/dev/syscon 
/dev/systty 
/etc/profile 


SEE ALSO 


conlocate(1M), getty(1M), login(1), sh(1), who(1), kill(2), 
inittab(4), profile(4), utmp(4). 


DIAGNOSTICS 


If inzt finds that it is continuously respawning an entry 
from /ete/inittab more than 10 times in 2 minutes, it 
will assume that there is an error in the command string, 
and generate an error message on the system console, 
and refuse to respawn this entry until either 5 minutes 
has elapsed or it receives a signal from a user init 
(telinit). This prevents intt from eating up system 
resources when someone makes a typographical error in 
the intttad file or a program is removed that is 
referenced in the intttab. 


INSTALL (1M) 


NAME 
install ~ install commands 

SYNOPSIS 
etc/install [-c dira] [-f dirb] [-i] [-n dirc] [-o] 
—s| file [dirx ... 

DESCRIPTION 


Insiali is a command most commonly used in 
“makefiles” (see make(1)) to install a file (updated 
target file) in a specific place within a file system. Each 
file is installed by copying it into the appropriate 
directory, thereby retaining the mode and owner of the 
original command. The program prints messages telling 
the user exactly what files it is replacing or creating and 
where they are going. 


If no options or directories (dirz ...) are given, install 
will search a set of default directories (/bin, /usr/bin, 
/ete, /lib, and /usr/lib, in that order) for a file with 
the same name as file. When the first occurrence is 
found, install issues a message saying that it is 
overwriting that file with file, and proceeds to do so. If 
the file is not found, the program states this and exits 
without further action. 


If one or more directories ee ...) are specified after 
file, those directories will be searched before the 
directories specified in the default list. 


The meanings of the options are: 


—e dira Installs a new command (file) in 
the directory specified by dtra, 
only if it is not found. If it is 
found, tnstall issues a message 
saying that the file already exists, 
and exits without overwriting it. 
May be used alone or with the —s 
option. 


-f dirb Forces file to be installed in given 
directory, whether or not one 
already exists. If the file being 
installed does not already exist, 
the mode and owner of the new 
file will be set to 755 and bin, 
respectively. If the file already 
exists, the mode and owner will be 
that of the already existing file. 
May be used alone or with the —o 
or —8 options. 
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—n dire 


SEE ALSO 


cpset(1M), make(1). 


Ignores default directory list, 
searching only through the given 
directories (dirr ...). May be 
used alone or with any other 
options other than —c and -f. 


If file is not found in any of the 
searched directories, it is put in 
the directory specified in dire. 
The mode and owner of the new 
file will be set to 755 and bin, 
respectively. May be used alone 
or with any other options other 
than —c and —f. 


If file is found, this option saves 
the “found”? file by copying it to 
OLDfile in the directory in which 
it was found. This option is 
useful when installing a normally 
text busy file such as /bin/sh or 
/ete/getty, where the existing 
file cannot be removed. May be 
used alone or with any other 
options other than —c. 


Suppresses printing of messages 
other than error messages. May 
be used alone or with any other 
options. 


NAME 


IPCRM(1) 


ipcrm — remove a message queue, semaphore set or 
shared memory id 


SYNOPSIS 


iperm [ options | 


DESCRIPTION 


Iperm will remove one or more specified messages, 
semaphore or shared memory identifiers. The identifiers 
are specified by the following opttons: 


—q msgid 


—m shmid 


—s semid 


—-Q msgkey 


—M shmkey 


—S semkey 


removes the message queue identifier msqtd 
from the system and destroys the message 
queue and data structure associated with 
it. 

removes the shared memory identifier 
shmid from the system. The _ shared 
Memory segment and _ data _ structure 
associated with it are destroyed after the 
last detach. 


removes the semaphore identifier semid 
from the system and destroys the set of 
semaphores and data structure associated 
with it. 

removes the message queue identifier, 
created with key msgkey, from the system 
and destroys the message queue and data 
structure associated with it. 


removes the shared memory identifier, 
created with key shmkey, from the system. 
The shared memory segment and data 
structure associated with it are destroyed 
after the last detach. 


removes the semaphore identifier, created 
with key semkey, from the system and 
destroys the set of semaphores and data 
structure associated with it. 


The details of the removes are described in msgctk2), 
shmetK(2), and semct(2). The identifiers and keys may 
be foun by using ipcea(1). 


SEE ALSO 


ipes(1), _msgctl(2), 
semget(2), semop(2), shmctl(2 shmget(2 


ee) prea ) a 2), 
shmop 
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NAME 
ipcs ~ report inter-process communication facilities 
status 

SYNOPSIS 
ipes { options | 

DESCRIPTION 


Ipes prints certain information about. active inter-process 
communication facilities. Without options, information 
is printed in short format for message queues, shared 
memory, and semaphores that are currently active in the 
system. Otherwise, the information that is displayed is 
controlled by the following opttons: 


—q Print information about active message 
queues. 

—m Print information about active shared 
memory segments. 

—8 Print information about active semaphores. 


If any of the options —q, —m, or —s are specified, 

information about only those indicated will be printed. 

If none of these three are specified, information about all 

three will be printed. 

—b Print biggest allowable size information. 
(Maximum number of bytes in messages on 
queue for message queues, size of segments 
for shared memory, and number of 
semaphores in each set for semaphores.) 
See below for meaning of columns in a 


listing. 

—c¢ Print creator’s login name and group 
name. See below. 

-o Print information on outstanding usage. 


(Number of messages on queue and total 
number of bytes in messages on queue for 
message queues and number of processes 
attached to shared memory segments.) 

—p Print process number _ information. 
(Process ID of last process to send a 
message and process ID of last process to 
receive a message on message queues and 
process ID of creating process and process 
ID of last process to attach or detach on 
shared memory segments) See below. 

—t Print time information. (Time of the last 
control operation that changed the access 
permissions for all facilities. Time of last 
msgsnd and last msgrev on message 
queues, last shmat and last shmdt on 
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shared memory, last semop(2) on 
semaphores.) See below. 

—a Use all print options. (This is a shorthand 
notation for —b, —c, —o, —p, and -t.) 

-C corefile Use the file corefile in place of 


pdey emer: 

—N namelist The argument will be taken as the name of 
an alternate namelist (/unix is the 
default). 


The column headings and the meaning of the columns in 
an tpces listing are given below; the letters in parentheses 
indicate the options that cause the corresponding 
heading to appear; all means that the heading always 
appears. Note that these options only determine what 
information is provided for each facility; they do not 
determine which facilities will be listed. 


T (all) Type of the facility: 

q message queue; 

m shared memory segment; 

8 semaphore. 
ID all) The identifier for the facility entry. 
KEY all) The key used as an argument to 


msgget, semget, or shmget to create 
the facility entry. (Note: The key of 
a shared memory segment is changed 
to IPC_PRIVATE when the segment 
has been removed until all processes 
attached to the segment detach it.) 
MODE (all) The facility access modes and flags: 
The mode consists of 11 characters 
that are interpreted as follows: 
The first two characters are: 

Rif a process is waiting on 
a msgrcv; 

Sif a process is waiting on 
a msgsend; 

D_ if the associated shared 
memory segment has been 
removed. It will 
disappear when the last 
process attached to the 
segment detaches it; 

C if the associated shared 
memory segment is to be 
cleared when the first 
attach is executed; 

— if the corresponding 
special flag is not set. 


OWNER 
GROUP 
CREATOR 
CGROUP 


CBYTES 


QNUM 


QBYTES 


LSPID 


LRPID 


STIME 
RTIME 


all) 
all) 


( 
( 
(a,c) 
(a,c) 
( 


a,o) 
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The next 9 characters are interpreted 
as three sets of three bits each. The 
first set refers to the owner’s 
permissions; the next to permissions of 
others in the user-group of the facility 
entry; and the last to all others. 
Within each set, the first character 
indicates permission to read, the 
second character indicates permission 
to write or alter the facility entry, and 
the last character is currently unused. 


The permissions are indicated as 
follows: 


r if read permission is 


granted; 

w if write permission is 
granted; 

a if alter permission is 
granted; 


~— if the indicated permission 
is not granted. 

The login name of the owner of the 
facility entry. 
The group name of the group of the 
owner of the facility entry. 
The login name of the creator of the 
facility entry. 
The group name of the group of the 
creator of the facility entry. 
The number of bytes in messages 
currently outstanding on the 
associated message queue. 
The number of messages currently 
outstanding on the associated message 
queue. 
The maximum number of bytes 
allowed in messages outstanding on 
the associated message queue. 
The process ID of the last process to 
send a message to the associated 
queue. 
The process ID of the last process to 
receive a message from the associated 
queue. 
The time the last message was sent to 
the associated queue. 
The time the last message was 
received from the associated queue. 


Sas 


FILES 


CTIME 
NATTCH 


SEGSZ 
CPID 
LPID 


ATIME 
DTIME 


NSEMS 
OTIME 


/unix 
/dev/kmem 
/etc/passwd 


/etc/group 


SEE ALSO 
msgop(2), semop(2), shmop(2). 


BUGS 


(a,t) 
(a,0) 


(a,b) 


(a,p) 


— 


(a,p 
(a,t) 
(a,t) 


(a,b) 
(a,t) 
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The time when the associated entry 
was created or changed. 

The number of processes attached to 
the associated shared memory 
segment. 

The size of the associated shared 
memory segment. 

The process ID of the creator of the 
shared memory entry. 

The process ID of the last process to 
attach or detach the shared memory 
segment. 

The time the last attach was 
completed to the associated shared 
memory segment. 

The time the last detach was 
completed on the associated shared 
memory segment. 

The number of semaphores in the set 
associated with the semaphore entry. 
The time the last semaphore operation 
was completed on the set associated 
with the semaphore entry. 


system namelist 
memory 

user names 
group names 


Things can change while tpcs is running; the picture it 
gives is only a close approximation to reality. 


CSPLIT (1) 


Inno A file is to be created from the current 
line up to (but not including) Inno. The 
current line becomes Inno. 


{num} Repeat argument. This argument may 
follow any of the above arguments. If it 
follows a rezp type argument, that 
argument is applied num more times. If 
it follows Inno, the file will be split every 
Inno lines (num times) from that point. 

Enclose all rerp type arguments that contain blanks or 
other characters meaningful to the Shell in the 
appropriate quotes. Regular expressions may not contain 
embedded new-lines. Csplit does not affect the original 
file; it is the users responsibility to remove it. 


EXAMPLES 
esplit —f cobol file '/procedure 
division/’ /par5./ /parl6./ 


This example creates four files, cobol00 . . . cobol03. 
After editing the “‘split”’ files, they can be recombined as 
follows: 


cat cobol0[0-3] > file 
Note that this example overwrites the original file. 


esplit —k file 100 {99} 
This example would split the file at every 100 lines, up 
to 10,000 lines. The —k option causes the created files 
to be retained if there are less than 10,000 lines; 
however, an error message would still be printed. 


esplit —k prog.c '%main(%! '/*}/+1' {20} 
Assuming that prog.ec follows the normal C coding 
convention of ending routines with a } at the beginning 
of the line, this example will create a file containing each 
separate C routine (up to 21) in prog.c. 


SEE ALSO 
ed(1), sh(1), regexp(5). 
DIAGNOSTICS 
Self explanatory except for: 
arg — out of range 
which means that the given argument did not reference a 
line between the current position and the end of the file. 


CT(1C) 


NAME 

ct — spawn getty to a remote terminal 
SYNOPSIS 

ct { —h ] [ -v | { —wn ] [ —sspeed ] telno ... 
DESCRIPTION 


FILES 


Ct dials the phone number of a modem that is attached 
to a terminal, and spawns a getty process to that 
terminal. Teino is a telephone number, with equal signs 
for secondary dial tones and minus signs for delays at 
appropriate places. If more than one telephone number 
is specified, ct will try each in succession until one 
answers; this is useful for specifying alternate dialing 
paths. 


Ct will try each line listed in the file 
/usr/lib/uucp/Devices until it finds an available line 
with appropriate attributes or runs out of entries. If 
there are no free Jines, ct will ask if it should wait for 
one, and if so, for how many minutes it should wait 
before it gives up. Cé# will continue to try to open the 
dialers at one-minute intervals until the specified limit is 
exceeded. The dialogue may be overridden by specifying 
the —wn option, where n is the maximum number of 
minutes that ct is to wait for a line. 


Normally, cf will hang up the current line, so that that 
line can answer the incoming call. The —h option will 
prevent this action. If the —v option is used, cé will 
send a running narrative to the standard error output 
stream. 


The data rate may be set with the —s option, where 
speed is expressed in baud. The default rate is 300. 


After the user on the destination terminal logs out, ct 
prompts, Reconnect? If the response begins with the 
letter n the line will be dropped; otherwise, getty will be 
started again and the login: prompt will be printed. 


Of course, the destination terminal must be attached to 
a modem that can answer the telephone. 


/usr/lib/uucp/Devices 
/usr /spool /locks/LCK.* 
/usr/adm/ctlog 


SEE ALSO 
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cu(1C), login(1), wucp(1C). 


CTAGS(1) 


NAME 
ctags — create a tags file 

SYNOPSIS 
ctags | -u | | —v | { -w ] [ —x | name ... 

DESCRIPTION 
Ctags creates a tags file, tags, from the specified C, 
Pascal, and FORTRAN sources. The ez({1) tags 
command uses a tags file to find specified objects, 
functions in this case, in a group of files. Each line of 
the tags file contains the function name, the file in which 
it is defined, and a scanning pattern used to find the 
function definition, with the fields separated by blanks 
or tabs. 
If a file’s name ends with .c or -h, it is searched for C 
function and macro definitions. The main function is 
treated as a special case, so as to permit multiple 
programs in one directory: the tag is the name of the 
file, striped of leading directory names and trailing .c, 
with M prepended. 
If a file’s name does not end with .e or -h, it is searched 
for Pascal definitions, then for FORTRAN definitions, 
then for C definitions. 
These are the options: 
-w No warning diagnostics. 
—u Update the tags file. (It is usually faster just to 

rebuild the tags file.) 
—a Append new definitions to the end of the tags file. 
~—x Process a list of function definitions, with line 
numbers and file names. 

FILES 
tags output tags file 

SEE ALSO 
ex(1), vi(1). 

AUTHOR 
Ken Arnold; FORTRAN added by Jim Kleckner; Bill 
Joy added Pascal and ~—x replacing czref; C typedefs 
added by Ed Pelegri-Llopart. 

WARNING 


Recognition of FORTRAN and Pascal objects is done is a 
very simpleminded way. No attempt is made to deal 
with block structure. 
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NAME 

ctinstall ~ install software 
SYNOPSIS 

/install/ctinstall { update | install ] [ groups ... | 
DESCRIPTION 


Ctinstall is used to install software from quarter-inch 
tape and diskette media. It must be invoked in single- 
user mode. 


Note: Not all software can be installed with ctinstall; 
check the software Release Notice for applicability. 


If no arguments are provided to cttnstall, the user will be 
prompted for the required information. The option 
install is for raw, or first installs; update is for software 
updates; groups is any number of group names specified 
in the software product’s associated proto file. 


EXAMPLE 


A sample installation session is illustrated here. User 
responses are shown in bold type. 


# ed / 

# halt 

Ok To Stop Or Reset Processor 
# /install/ctinstall 


Q(#)ctinstall 11 
Positioning the Tape for Product Installation. 
Update or new installation of ISAM 5.00 (‘update’ or ’install’)?: install 


Running fsck on root file system. 
If there are any problems the system will re-boot. 
After the system is back up re-execute /install/ctinstall in single user mode. 


/ dev /dsk /cOd0s1 
File System: Volume: 


** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 
** Phase 5 - Check Free List 

NNN files NNNN blocks NNNN free 


Unmounting /usr. 


Running fsck on /usr file system. 
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—mtime n 
—ctime n 


—exec cmd 


~ok emd 


—print 


—epio device 


—newer file 


-inum n 


—depth 


( expression ) 


FIND (1) 


True if the file has been modified in n 
days. 


True if the file has been changed in n 
days. 


True if the executed cmd returns a 
zero value as exit status. The end of 
emd must be punctuated by an 
escaped semicolon. A command 
argument {} is replaced by the current 
path name. 


Like —exec except that the generated 
command line is printed with a 
question mark first, and is executed 
only if the user responds by typing y. 


Always true; causes the current path 
name to be printed. 


Always true; write the current file on 
device in cpio (4) format (5120-byte 
records). 


True if the current file has been 
modified more recently than the 
argument file. 


True if the current file is inode 
number n. 


Always true; causes descent of the 
directory hierarchy to be done so that 
all entries in a directory are acted on 
before the directory itself. This can be 
useful when find is used with cpio(1) 
to transfer files that are contained in 
directories without write permission. 


True if the parenthesized expression is 
true (parentheses are special to the 
shell and must be escaped). 


The primaries may be combined using the following 
operators (in order of decreasing precedence): 


1) The negation of a primary (! is the unary not 


operator). 


2) Concatenation of primaries (the and operation is 
implied by the juxtaposition of two primaries). 


3) Alternation of primaries (—o is the or operator). 


EXAMPLE 


To remove all files named a.out or *.o that have not 


-2- 


FIND (1) 


been accessed for a week: 

find / \(-name a.out -o —name ‘*.o \) 

—atime +7 ~exec rm {} \ 
FILES 

/etc/passwd, /etc/group 
SEE ALSO ee 

chmod(1), cpio(1), sh(1), test(1), stat(2), epio(4), fs(4). 


¥ 
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NAME 

fold — fold long lines for finite width output device 
SYNOPSIS 

fold { -columns | | file ... | 
DESCRIPTION 


Fold produces a folded version of its input, inserting 
newlines so that none of its output lines is wider than 
columns. If columns is omitted, folding is done at 80 
columns. 


If tabs are present in the input, columna should be a 
multiple of eight. 

SEE ALSO 
expand(1) 


WARNING 
Overstriking can be spoiled by folding. 


NAME 


FREC(1M) 


frec — recover files from a backup tape 


SYNOPSIS 


/etc/frec [—p path] | -f reqfile] raw-tape 
i-number:name ... 


DESCRIPTION 


Frec recovers files from the specified raw-tape backup 
tape written by volcopy{1M) or 1 i 
numbers. The data for each recovery request will be 


written into the file given by name. 


iY 
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The —p option allows you to specify a default prefixing 
path different from your current working directory. This 
will be prefixed to any names that are not fully 
qualified, i.e., that do not begin with / or ./. If any 
directories are missing in the paths of recovery names 
they will be created. 


—p path Specifies a prefixing path to be used to 
fully qualify any names that do not 
start with / or ./. 


—-f regfile Specifies a file which contains recovery 
requests. The format is i- 
number:newname, one per line. 


EXAMPLES 


To recover a file, i-number 1216 when backed-up, into a 
file named junk in your current working directory: 
frec /dev/rmtO 1216:junk 


To recover files with i-numbers 14156, 1232, and 3141 
into files /usr/sre/emd/a, /usr/src/emd/b and 
/usr /joe/a.c: 
frec —p /usr/src/emd /dev/rmtO 14156:a 
1232:b 3141:/usr/joe/a.c 


SEE ALSO 


BUGS 


epio(1), ff(1M), finc(1M), volcopy(1M). 


While paving a path (i.e., creating the intermediate 
directories contained in a pathname) free can only 
recover i-node fields for those directories contained on 
the tape and requested for recovery. 


NAME 


FSCK(1M) 


fsck, dfsck - file system consistency check and 
interactive repair 


SYNOPSIS 


etc/fsck [-— —n} |~se:s} |-s} |—Sczs| |-S} |—t file 
(Sr or (ot ent oF kay fade atoms | 
pste/dteck { options! | filsysl ... — [ options2 | 
ulsys2 ... 


DESCRIPTION 
Fsck 
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Fsck audits and interactively repairs inconsistent 
conditions for CTIX system files. If the file system is 
consistent, the number of files, number of blocks used, 
and number of blocks free are reported. If the file 
system is inconsistent, the operator is prompted for 
concurrence before each correction is attempted. It 
should be noted that some corrective actions will result 
in some loss of data. The amount and severity of data 
lost may be determined from the diagnostic output. The 
default action for each consistency correction is to wait 
for the operator to respond yes or no. If the operator 
does not have write permission fsck will default to a —n 
action. Upon completion fsck reports the number of used 
and free 1024-byte blocks and the number of files in the 
filesystem. 


Modifying a mounted file system requires special 
precautions by feck, because a single syne (2) will undo 
all of fsck’s repair work. To prevent this, fsck performs 
a syslocal(2) RESYNC. The system call forces CTIX to 
reread the superblock from the disk. 


Fsck has more consistency checks than its predecessors 
check, dcheck, feheck, and teheck combined. 


The following options are interpreted by fsck. 


~y Assume a yes response to all questions asked by 
feck. 


—n Assume a no response to all questions asked by 
fsck; do not open the file system for writing. 


—8C3S 


—s Ignore the actual free list or bit map and 
(unconditionally) reconstruct a new one by 
rewriting the super-block of the file system. The 
file system should be unmounted while this is 
done; if this is not possible, care should be taken 
that the system is quiescent. 


—Sezs 
-S 


-t 


-q 


-D 


-f 


—p 
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If ess is given on a standard file system, the free 
list is organized with ¢ blocks per cylinder and s 
blocks skipped. If c:s is omitted, the values 
originally specified to mkfs are used. If these 
vei were not specified, then the value 400:7 is 
used. 


Conditionally reconstruct the free list or bit map. 
This option is like —s above except that the free 
list or bit map is rebuilt only if there were no 
discrepancies discovered in the file system. Using 
—S will force a no response to all questions asked 
by fsck. This option is useful for forcing free list 
or bit map reorganization on uncontaminated file 
systems. 


If feck cannot obtain enough memory to keep its 
tables, it uses a scratch file. If the —t option is 
specified, the file named in the next argument is 
used as the scratch file, if needed. Without the —t 
flag, feck will prompt the operator for the name 
of the scratch file. The file chosen should not be 
on the file system being checked, and if it is not a 
special file or did not already exist, it is removed 
when fsck completes. 


Quiet fsck. Do not print size-check messages in 

hase 1. Unreferenced fifos will silently be 
removed. If feck requires it, counts in the 
superblock will be automatically fixed and the 
free list or bit map salvaged. 


Directories are checked for consistency. Useful 


after system crashes. The following 

inconsistencies are sought: 

e Entries with null names but nonzero i- 
numbers. 

e Entries that are not padded to full size 
with nulls. 

® Invalid . and .. entries. 

° Names that contain “/”’. 

e Final blocks that are not cleared past 
end-of-file. 


Fast check. Check block and sizes (Phase 1) and 
check the free list or bit map (Phase 5). The free 
list or bit map will be reconstructed (Phase 6) if it 
is necessary. 

Preen file systems only; intended for auto boot. 
No operator input is prompted for. Instead, fsck 
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applies standard fixes whenever the fix doesn’t 
involve loss of data. Only the following problems 
are subject to this kind of fix: 


Unreferenced i-nodes. 

Link counts in i-nodes too large. 
Missing blocks in the free list. 
Blocks in the free list also in files. 
Counts in the super block wrong. 


Any problem not of this type causes fsck to ~_ 
terminate with an error status. The startup script 
that runs fsck (normally pete peheck es) can 


specify the —p option to fee 


and make a normal 


boot contingent upon a normal fsck return status. 


~bor -B 


Resync file system after modifying (if file system 
was mounted). 


~M_ Convert file system to new bit map free list 


format. 


-O Convert file system to old free list format. 
Both —M and —O imply —s. 


If no file-systems are specified, feck will read a list of 
default file systems from the file /ete/checklist. 


Inconsistencies checked are as follows: 


Lg 


mo 


SES 


Blocks claimed by more than one i-node 
or the free list. 
Blocks claimed by an i-node or the free 
list outside the range of the file system. 
Incorrect link counts. 
Size checks: 
Incorrect number of blocks. 
Directory size not 16-byte aligned. 
Bad i-node format. 
Blocks not accounted for anywhere. 
Directory checks: 
File pointing to unallocated i-node. 
I-node number out of range. 
Super Block checks: 
More than 65536 i-nodes. 
More blocks for i-nodes than there 
are in the file system. 
Bad free block list format. 
Total free block and/or free i-node count 
incorrect. 
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Orphaned files and_ directories (allocated but 
unreferenced) are, with the operator’s concurrence, 
reconnected by placing them in the lost+found 
directory, if the files are nonempty. The user will be 
notified if the file or directory is empty or not. If it is 
empty, feck will silently remove them. F'sck will force 
the reconnection of nonempty directories. The name 
assigned is the i-node number. The only restriction is 
that the directory lost+found must preexist in the root 
of the file system being checked and must have empty 
slots in which entries can be made. The lost+found 
directory is normally created by running 
mklost+found(1M) just after the file system is created 
with mkfs(1M). 


Checking the raw device is almost always faster and 
should almost always be used. 


Dfsck 


NOTE 


Dfsck allows two file system checks on two different 
drives simultaneously. opttonsi1 and opttons2 are used 
to pass options to fsck for the two sets of file systems. A 
— is the separator between the file system groups. 


The dfsck program permits an operator to interact with 
two fsck(1M) programs at once. To aid in this, dfsck 
will print the file system name for each message to the 
operator. When answering a question from dfsck, the 
operator must prefix the response with a 1 or a 2 
ae that the answer refers to the first or second 
ile system group). 


Do not use dfsck to check the root file system. 


The —b option is safe to use on unmounted file systems; 
however, whenever possible, unmount file systems 
instead of using the —b option. 


The raw device should always be used with mounted file 
systems. 


FILES 
/ete/checklist contains default list of file 
systems to check. 
/etc/checkall optimizing dfsck shell file. 
SEE ALSO 
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clri(IM), init(1M), mklost+found(1M), ncheck(1M), 
checklist(4), fs(4). 

MintFrame Administrator’s Reference Manual. 
MightyFrame Administrator’s Reference Manual. 
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BUGS 
I-node numbers for . and .. in each directory should be 
checked for validity. 


DIAGNOSTICS 
The diagnostics produced by fsck are intended to be 
self-explanatory. 
If —p was specified and preening was inadequate, 4 
nonzero status is returned. 
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NAME 

{sdb — file system debugger 
SYNOPSIS 

/ete/fsdb special | — | 
DESCRIPTION 


Fsdb can be used to patch up a damaged file system 
after a crash. It has conversions to translate block and 
i-numbers into their corresponding disk addresses. Also 
included are mnemonic offsets to access different parts of 
an i-node. These greatly simplify the process of 
correcting control block entries or descending the file 
system tree. 


Fsdb contains several error-checking routines to verify i- 
node and block addresses. These can be disabled if 
necessary by invoking fsdb with the optional — argument 
or by the use of the O symbol. (Fsdb reads the i-size 
and f-size entries from the superblock of the file system 
as the basis for these checks.) 


Numbers are considered decimal by default. Octal 
numbers must be prefixed with a zero. During any 
assignment operation, numbers are checked for a possible 
truncation error due to a size mismatch between source 
and destination. 


Fsdb reads a block at a time and will therefore work 
with raw as well as block I/O. A buffer management 
routine is used to retain commonly used blocks of data in 
order to reduce the number of read system calls. All 
assignment operations result in an immediate write- 
through of the corresponding block. 


The symbols recognized by fsdb are: 
absolute address 
convert from i-number to i-node 
address 
convert to byte address 
directory slot offset 

/ address arithmetic 
quit 
save, restore an address 
numerical assignment 
incremental assignment 
decremental assignment 
character string assignment 
error checking flip flop 
general print facilities 
file print facility 
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double word mode 
escape to shell 


F buffer status 

x hexadecimal or octal address flip- 
flop (default is hexadecimal) 

B byte mode 

WwW word mode 

D 

! 


The print facilities generate a formatted output in 

various styles. The current address is normalized to an 

appropriate boundary before printing begins. It 

advances with the printing and is left at the address of 

the last item printed. The output can be terminated at 

any time by typing the delete character. If a number 

follows the p symbol, that many entries are printed. A 

check is made to detect block boundary overflows since 

logically sequential blocks are generally not physically 

sequential. If a count of zero is used, all entries to the 

end of the current block are printed. The print options 

available are: 
i print as i-nodes 

print as directories 

print as octal words 

print as decimal words 

print as characters 

print as octal bytes 

print as superblock 

print as hexadecimal words 

print as hexadecimal bytes 


The f symbol is used to print data blocks associated 
with the current i-node. If followed by a number, that 
block of the file is printed. (Blocks are numbered from 
zero.) The desired print option letter follows the block 
number, if present, or the f symbol. This print facility 
works for small as well as large files. Jt checks for 
special devices and that the block pointers used to find 
the data are not zero. 


Dots, tabs, and spaces may be used as function 
delimiters but are not necessary. A line with just a 
new-line character will increment the current address by 
the size of the data type last printed. That is, the 
address is set to the next byte, word, double word, 
directory entry or i-node, allowing the user to step 
through a region of a file system. Information is printed 
in a format appropriate to the data type. Bytes, words 
and double words are displayed with the octal address 
followed by the value in octal and decimal. A .B or .D 
is appended to the address for byte and double word 
values, respectively. Directories are printed as a 


rx @oaeoa 
8 
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directory slot offset followed by the decimal i-number 
and the character representation of the entry name. L 
nodes are printed with labeled fields describing each 
element. 


The following mnemonics are used for i-node 
examination and refer to the current working i-node: 








md mode 
In link count 
uid user ID number 
gid group ID number 
Sz file size 
a# data block numbers (0 — 12) 
at access time 
mt modification time 
maj major device number 
min minor device number 
si #inodes field in superblock 
sf #blks field in superblock 
sdO s_dinfo{0] in superblock 
sdl s_dinfo]1} in superblock 
=BS set a blank superblock with file 
system type IK and a magic 
number 
EXAMPLES 
386i prints i-number 386 in an_ i-node 
format. This now becomes the current 
working i-node. 
In=4 changes the link count for the working 
i-node to 4. 
In=+1 increments the link count by 1. 
fc prints, in ASCH, block zero of the file 
associated with the working i-node. 
2i.fd prints the first 32 directory entries for 
the root i-node of this file system. 
dii.fe changes the current i-node to that 
associated with the 5th directory entry 
(numbered from zero) found from the 
above command. he first logical 
block of the file is then printed in 
ASCII. 
512B.p00 prints the superblock of this file 
system in octal. 
2i.a0b.d7=3 changes the i-number for the seventh 


directory slot in the root directory to 
3. This example also shows how 
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several operations can be combined on 
one command line. 


d7.nm="name” changes the name field in the directory 
slot to the given string. Quotes are 
optional when used with nm if the 
first character is alphabetic. 

a2b.p0d prints the third block of the current i- 
node as directory entries. 


512.ps prints the superblock 


SEE ALSO 
fsck(1M), dir(4), fs(4). 
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NAME 
fsize — report file size 


SYNOPSIS 
/usr /local/bin/fsize 


DESCRIPTION 
Fsize reads the standard input to obtain a list of path 
names and calculates the size of the named files. The 
size of the files is reported in 512-byte blocks. 


If the files are nonexistent, fsize reports 0. 


EXAMPLES 
The following command computes the number of blocks 
used by the files and directories in the current working 
directory: 


Is | fsize 


The following command reports the number of blocks 
used by the files in a file list: 


cat filelist | fsize 


The following command reports the number of blocks 
used by all the files and directories in the entire subtree 
of the current working directory: 


find . —print | fsize 


SEE ALSO 
du(1). 
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NAME 

fsplit — split FORTRAN, ratfor, or ef] files 
SYNOPSIS 

fsplit { options | | files | 
DESCRIPTION 


Fsplit splits the named file(s) into separate files, with 
one procedure per file. A procedure includes blockdata, 
function, main, program, and subroutine program 
segments. Procedure X is put in file X.f, X.r, or X.e es 
depending on the language option chosen, with the 
following exceptions: main is put in the file MAIN.|[efr] 
and unnamed Oblockdata segments in the files 
blockdataN.[efr] where N is a unique integer value for 


each file. 

The following options pertain: 

-f (default) Input files are FORTRAN. 

-r Input files are ratfor. 

—e Input files are eff. 

-8 Strip FORTRAN input lines to 72 or fewer 


characters with trailing blanks removed. 


SEE ALSO 
esplit(1), split(1). 
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NAME 


FTP(1N) 


ftp — file transfer program 


SYNOPSIS 


ftp [-v ] | -d] [-i] [-m] [ -¢ J [ host | 


DESCRIPTION 


Ftp is the user interface to the ARPANET standard File 
Transfer Protocol. The program copies files to and from 
a remote node. It is more general than rep(1N), because 
a File Transfer Protocol server is available under a wider 
range of operating systems. 


The client node with which ftp is to communicate may 
be specified on the command line. If this is done, ftp will 
immediately attempt to establish a connection to an FTP 
server on that host; otherwise, ftp will enter its command 
interpreter and await instructions from the user. When 
ftp is awaiting commands, the prompt “ftp>’’ is 
displayed. 


COMMANDS 


The following commands are recognized by ftp. Each 
machine session begins with one or more open 
commands and and ends with one or more close or a 
single bye command. 


! Invoke a shell on the local machine. 


append local-file | remote-file | 
Append local-file to a file on the remote 
machine. If remote-file is left 
unspecified, the remote file is named 
after the local file. File transfer uses 
the current setting for type. 


ascii Set the file transfer type to network 
ASCII]. This is the default type. 

bell Arrange that a bell be sounded after 
each file transfer command is 
completed. 

binary Set the file transfer type to support 
binary image transfer. 

bye Terminate the FTP session with all the 


remote servers and exit ftp. 


ed remote-directory 
Change the working directory on the 
remote machine to remote-directory. 


close Terminate the FTP session with the 
current remote server, and return to the 
command interpreter. 


os 


copy hosti:filet 
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host2:file2 

Copy file1 of remote host host1 to file? 
of remote host host2 . Connection to 
host1 and host? must be opened prior to 
this command. The current setting for 
type must be the same for both remote 
servers. 


delete remote-file 


Delete the file remote-file on the remote 
machine. 


debug [ debug-value | 


Toggle debugging mode. If an optional 
debug-value is specified, it is used to set 
the debugging level. When debugging 
is on, ftp prints each command sent to 
the remote machine, preceded by the 
string ‘‘-->”’. 


dir [| remote-directory | { local-file | 


get remote-file 


glob 


hash 


help | commana 


Print a listing of the directory contents 
in the directory, remote-directory, and, 
optionally, place the output in local- 
file. If no directory is specified, the 
current working directory on the remote 
machine is used. If no local file is 
specified, output comes to the terminal. 


local-file | 

Retrieve the remote-file and store it on 
the local machine. If the local file 
name is not specified, it is given the 
same name it has on the remote 
machine. The current setting for type 
is used while transferring the file. 


Toggle file name globbing. With file 
name globbing enabled, each local file 
or pathname is processed for shell 
metacharacters. Remote files specified 
in mutiple item commands such as 
mput are globbed by the remote 
server. If globbing is disabled, all files 
and pathnames are treated literally. 


Toggle hash-sign (“#’’) printing for 
each data block transferred. The size of 
a data block is 1024 bytes. 


rint an informative message about the 
meaning of command. If no argument 
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is given, ftp prints a list of the known 
commands. 


led | directory] Change the working directory on the 
local machine. If no directory is 
specified, the user’s home directory is 
used. 


Is [| remote-directory | [ local-file | 

Print an abbreviated listing of the 
contents of a directory on the remote 
machine. If remote-directory is left 
unspecified, the current working 
directory is used. If no local file is 
specified, the output is sent to the 
terminal. 


mdelete remote-files 
Delete the specified files on the remote 
machine. If globbing is enabled, the 
specification of remote files will first be 
expanded using Is. 


mdir remote-files local-file 
Obtain a directory listing of multiple 
files on the remote machine and place 
the result in local-file. 


mget remote-files 
Retrieve the specified files from the 
remote machine and place them in the 
current local directory. If globbing is 
enabled, the specification of remote files 
will first be expanded using ls. 


mkdir directory-name 
Make a directory on the _ remote 
machine. 


mls remote-files local-file 
Obtain an abbreviated listing of 
multiple files on the remote machine 
and place the result in local-file. 


mput local-files Transfer multiple local files from the 
current local directory to the current 
working directory on the remote 
machine. 


open host [ port |. 

stablish a connection to the specified 
host FTP server. An _ optional port 
number may be supplied, in which case, 
ftp will attempt to contact an FTP 
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server at that port. If the auto-login 
option is on san) ftp will also 
attempt to automatically log the user in 
to the FTP server (see below). 
Connection to host becomes the current 
connection. Note that multiple 
connections can be made with the open 
command. The current connection can 
be changed by using the open 
command for an already connected 
host. 


prompt Toggle interactive prompting (on by 
default). Interactive prompting occurs 
during multiple file transfers to allow 
the user to selectively retrieve or store 
files. If prompting is turned off, any 
mget or mput will transfer all files. 


put local-file [ remote-file | 
Store a local file on the remote 
machine. If remote-file is left 
unspecified, the local file name is used 
in naming the remote file. File transfer 
uses the current setting for type. 


pwd Print the name of the current working 
directory on the remote machine. 


quit A synonym for bye. 


quote arg! arg2... 
The arguments specified are sent, 
verbatim, to the remote FTP server. A 
single FTP reply code is expected in 
return. 


recv remote-file | local-file | 
A synonym for get. 


remotehelp [| command-name | 
Request help from the remote FTP 
server. If a command-name is specified, 
it is supplied to the server as well. 


rename | from | | to | 
ename the file from on the remote 
machine, to the file to. 


rmdir directory-name 
Delete a directory on the remote 
machine. 


send local-file [| remote-file | 
A synonym for put. 
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sendport Toggle the use of PORT commands. By 
default, ftp will attempt to use a PORT 
command when establishing a 
connection for each data transfer. If 
the PORT command fails, ftp will use 
the default data port. When the use of 
PORT commands is_ disabled, no 
attempt will be made to use PORT 
commands for each data transfer. This 
is useful for certain FTP 
implementations which do ignore PORT 
commands but, incorrectly, indicate 
they’ve been accepted. 


status Show the current status of ftp. 

tenex Set the file transfer type to that needed 
to talk to TENEX machines. 

trace Toggle packet tracing. 


type [ tyBESBaImE | 

et the file transfer type to type-name. 
If no type is specified, the current type 
is printed. The default type is network 
ASCII . 


user user-name | password | | account } 

Identify yourself to the remote FTP 
server. If the password is not specified 
and the server requires it, ftp will 
prompt the user for it (after disabling 
local echo). If an account field is not 
specified, and the FTP server requires 
it, the user will be prompted for it. 
Unless ftp is invoked with “auto-login”’ 
disabled, this process is done 
automatically on initial connection to 
the FTP server. 


verbose Toggle verbose mode. In verbose mode, 
all responses from the FTP server are 
displayed to the user. In addition, if 
verbose is on, when a file transfer 
completes, statistics regarding the 
efficiency of the transfer are reported. 
By default, verbose is on. 


? [| command| A synonym for help. 


Command arguments which have embedded spaces may 
be quoted with quote (”) marks. 
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FILE NAMING CONVENTIONS 
Files specified as arguments to ftp commands are 
processed according to the following rules. 


1) If the file name ‘‘—” is specified, the standard 
input (for reading) or standard output (for 
writing) is used. 


bo 


— 


If the first character of the file name is ‘‘l”’, the 
remainder of the argument is interpreted as a 
shell command. Ftp then forks a shell, using 
popen(3) with the argument supplied, and reads 
(writes) from the stdout (stdin). If the shell 
command includes spaces, the argument must be 
quoted; e.g. “”| Is -lt””. A particularly useful 
example of this mechanism is: ‘‘dir |more’’. 


3) Failing the above checks, if “globbing” is 
enabled, local file names with © shell 
metacharacters are expanded. 


FILE TRANSFER PARAMETERS 
The FTP specification specifies many parameters which 
may affect a file transfer. The type may be one of 
“ascii”, “image” (binary), “ebcdic”’, and “local byte 
size” (for PDP-10s and PDP-20s mostly). Ftp supports 
the ASCII and image types of file transfer. 


Ftp supports only the default values for the remaining 
file transfer parameters: mode, form, and struct. 


OPTIONS 
Options may be specified at the command line, or to the 
command interpreter. 


The —v (verbose on) option forces ftp to show all 
responses from the remote server, as wel] as report on 
data transfer statistics. 


The —n option restrains ftp from attempting ‘‘auto- 
login” upon initial connection. If auto-login is enabled, 
ftp will check the .netre file in the user’s home directory 
for an entry describing an account on the remote 
machine. If no entry exists, ftp will use the login name 
on the local machine as the user identity on the remote 
machine, and prompt for a password and, optionally, an 
account with which to login. 


The -i option turns off interactive prompting during 
multiple file transfers. 


The —d option enables debugging. 
The —g option disables file name globbing. 
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WARNINGS 
Many FTP server implementations do not support the 
experimental operations such as print working directory. 


Aborting a file transfer does not work correctly; if one 
attempts this, the local ftp will likely have to be killed 
by hand. 


SEE ALSO 
rep(1N). 
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NAME 
ftpd — DARPA Internet File Transfer Protocol server 


SYNOPSIS 
/ete/ftpd | —d | [ -1 | [ —ttimeout | 

DESCRIPTION 
Ftpd is the DARPA Internet File Transfer Protocol server 
process. It is normally executed by the startup file, 
/ete/re. 
If the —d option is specified, each socket created will 
have debugging turned on (SO_DEBUG). With 
debugging enabled, the system will trace all TCP packets 
sent and received on a socket. 
If the —] option is specified, each FTP session is logged 
on the standard output. This allows a line of the form 


/ete/ftpd -1 > /tmp/ftplog 


to be used to conveniently maintain a log of FTP 
sessions. 


The FTP server will timeout an inactive session after 60 
seconds. If the —t option is specified, the inactivity 
timeout period will be set to timeout. 


The FTP server currently supports the following FTP 
requests; case is not distinguished. 


Request Description 


ACCT specify account (ignored) 

ALLO allocate storage (vacuously) 

APPE append to a file 

CWD change working directory 

DELE delete a file 

HELP give help information 

LIST give list files in a directory (‘‘Is -lg’’) 
MODE specify data transfer mode 

NLST give name list of files in directory (‘‘ls’’) 
NOOP do nothing 

PASS specify password 

PASV set the server in passive mode 
PORT specify data connection port 

QUIT terminate session 

RETR retrieve a file 

RNFR specify rename-from file name 
RNTO specify rename-to file name 

STOR store a file 

STRU specify data transfer structure 
TYPE specify data transfer type 

USER specify user name 

XCUP change to parent of current working directory 


ois 


FTPD(1NM) 


XCWD change working directory 

XMKD make a directory 

XPWD print the current working directory 
XRMD remove a directory 


The remaining FTP requests specified in Internet RFC 
765 are recognized, but not implemented. 


Ftpd interprets file names according to the ‘“globbing”’ 
conventions used by the shell. 


Fipd authenticates users according to three rules. 


1) The user name must be in the password data 
base, /etc/passwd, and not have a null 
password. In this case a password must be 
provided by the client before any file operations 
may be performed. 


2) The user name must not appear in the file 
/etc/ftpusers, if that file exists. 
3) If the user name is “anonymous” or “ftp”, an 


anonymous ftp account must be present in the 
password file (user “ftp’’). In this case the user 
is allowed to log in by specifying any password; 
by convention this is given as the client host’s 
name. 


In the last case, ftpd takes special measures to restrict 
the client’s access privileges. The server performs a 
creat?) command to the home directory of the “‘ftp”’ 
user. In order that system security is not breached, it is 
recommended that the ‘ftp’ home directory be 
constructed with care; the following rules are 
recommended. 


$HOME Make the home directory owned by ‘‘ftp”’ 
and unwritable by anyone. 


$HOME/bin Make this directory owned by the 
superuser and unwritable by anyone. 
The program /s(1) must be present to 
support the hst commands. This 
program should have mode 111. 

$HOME/etc Make this directory owned by the 
superuser and unwritable by anyone. 
The files passwd(5) and group(5) must be 
present for the /s command to work 
properly. These files should be mode 
444. 

$HOME/pub- Make this directory mode 777 and owned 
by “ftp.” Users should then place files 
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which are to be accessible via the 
anonymous account in this directory. 


SEE ALSO 
ftp(1N). 
“File Transfer Protocol,’’ RFC 765 in Internet Protocol 


Transition Workbook, March 1982. Network Information 
Center, SRI International, Menlo Park, CA 94025. 


gUCE 


WARNINGS 
There is no support for aborting commands. 


The anonymous account is inherently dangerous and 
should be avoided when possible. 


The server must run as the superuser to create sockets 
with privileged port numbers. It maintains an effective 
user id of the logged in user, reverting to the superuser 
only when binding addresses to sockets. The possible 
security holes have been extensively scrutinized, but are 
possibly incomplete. 


NAME 


FUSER (1M) 


fuser — identify processes using a file or file structure 


SYNOPSIS 


/ete/fuser {—ku] files [—] [{—ku] files ] 


DESCRIPTION 


Fuser lists the process IDs of the processes using the files 
specified as arguments. For block special devices, ail 
processes using any file on that device are listed. The 
process ID is followed by ec, p or r if the process is using 
the file as its current directory, the parent of its current 
directory (only when in use by the system), or its root 
directory, respectively. If the —u option is specified, the 
login name, in parentheses, also follows the process ID. 
In addition, if the —k option is specified, the SIGKILL 
signal is sent to each process. te the super-user can 
terminate another user’s process (see kill(2 Options 
may be respecified between groups of files. he new set 
of options replaces the old set, with a lone dash canceling 
any options currently in force. 


The process IDs are printed as a single line on the 
standard output, separated by spaces and terminated 
with a single new line. All other output is written on 
standard error. 


EXAMPLES 


FILES 


fuser ~ku /dev/dsk/c0d01s1 
When run by the superuser, terminates all 
processes that are preventing cartridge file 
systems from being unmounted, listing the 
process ID and login name of each process as it is 


killed. 


fuser —u /etc/passwd 
Lists process IDs and login names of processes 
that have the password file open. 


fuser —ku /dev/dsk/cO0d0s1 —u /etc/passwd 
Does both of the above examples in a single 
command line. 


/unix for namelist 
/dev/kmem for system image 
/dev/mem also for system image 


SEE ALSO 


mount(1M), ps(1), kill(2), signal(2). 


NAME 


FWTMP (1M) 


fwtmp, wtmpfix - manipulate connect accounting 
records 


SYNOPSIS 


Vase Mb /acct/wesaptie [fes 
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DESCRIPTION 
Fwtmp 


Fwtmp reads from the standard input and writes to the 
standard output, converting binary records of the type 
found in wtmp to formatted ASCII records. The ASCII 
version is useful to enable editing, via ed(1), bad records 
or general purpose maintenance of the file. 


The argument —iec is used to denote that input is in 
ASCII form, and output is to be written in binary form. 
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FILES 


Witmpfizr is not currently available on MiniFrame. 
Wtmpfiz examines the standard input or named files in 
wtmp format, corrects the time/date stamps to make 
the entries consistent, and writes to the standard output. 
A — can be used in place of files to indicate the standard 
input. If time/date corrections are not performed, 
acctcon1 will fault when it encounters certain date- 
change records. 


Each time the date is set, a pair of date change records 
are written to /ete/wtmp. The first record is the old 
date denoted by the string old time placed in the line 
field and the flag OLD_TIME placed in the type field of 
the <utmp.h> structure. The second record specifies 
the new date and is denoted by the string new time 
placed in the line field and the flag NEW_TIME placed 
in the type field. Wtmpftz uses these records to 
synchronize al] time stamps in the file. 


In addition to correcting time/date stamps, wtmp/fiz will 
check the validity of the name field to ensure that it 
consists soley of alphanumeric characters or spaces. If it 
encounters a name that is considered invalid, it will 
change the login name to INVALID and write a 
diagnostic to the standard error. In this way, witmpfiz 
reduces the chance that acctconi will fail when 
processing connect accounting records. 


/ete/wtmp 
/usr/include/utmp.h 


FWTMP (1M) 


SEE ALSO 
acct(1M),  acctems(1M), | acctcom(1), _acctcon{1M), 
acctmerg(1M), acctprc(1M), acctsh(1M), ed(1), 
runacct(1M), acct(2), acct(4), utmp(4). 
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hpd, erase, hardcopy, tekset, td - graphical device 
routines and filters 


SYNOPSIS 


hpd [options] [GPS file ...] 


erase 


hardcopy 
tekset 


td [-eurn] [GPS file ...| 


DESCRIPTION 


All of the commands described below reside in 
/usr/bin/graf (see graphics(1G)). 


hpd 


erase 


Hpd translates a GPS (see gps(4)), to 
instructions for the Hewlett-Packard 7221A 
Graphics Plotter. A viewing window is 
computed from the maximum and minimum 
points in file unless the —u or —r option is 
provided. If no file is given, the standard 
input is assumed. Options are: 


en Select character set n, n between 0 and 
5 (see the HP7221A Plotter Operating 
a). Programming Manual, Appendix 
A). 

pn Select pen numbered n, n between 1 
and 4 inclusive. 


rn Window on GPS region n, n between 1 
and 25 inclusive. 


sn Slant characters n degrees clockwise 
from the vertical. 


u Window on the entire GPS universe. 


xdn Set x displacement of the viewport’s 
lower left corner to n inches. 


xvn Set width of viewport to n inches. 


ydn Set y displacement of the viewport’s 
lower left corner to n inches. 


yvn Set height of viewport to n inches. 


Erase sends characters to a TEKTRONIX 4010 
series storage terminal to erase the screen. 


hardcopy When issued at a TEKTRONIX display 


tekset 


terminal with a hard copy unit, hardcopy 
generates a screen copy on the unit. 


Tekset sends characters to a TEKTRONIX 
terminal to clear the display screen, set the 


a 


td 
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display mode to alpha, and set characters to 
the smallest font. 


Td translates a GPS to scope code for a 

TEKTRONIX 4010 series storage terminal. A 

viewing window is computed from _ the 

maximum and minimum points in file unless 

the —u or —r option is provided. If no file is 

given, the standard input is assumed. 

Options are: 

e Do not erase screen before initiating 
display. 

rn_ Display GPS region n, n between 1 and 
25 inclusive. 


u Display the entire GPS universe. 


ged(1G), graphics(1G), gps(4). 
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ged — graphical editor 


SYNOPSIS 


ged |-euRrn| [GPS file ...| 


DESCRIPTION 


Ged is an interactive graphical editor used to display, 
construct, and edit GPS files on TEKTRONIX 4010 series 
display terminals. If GPS file(s) are given, ged reads 
them into an internal display buffer and displays the 
buffer. The GPS in the buffer can then be edited. If — 
is given as a file name, ged reads a GPS from the 
standard input. 


Ged accepts the following command line options: 


e Do not erase the screen before the initial 
display. 


rn Display region number n. 
u Display the entire GPS universe. 
R___ Restricted shell invoked on use of !. 


A GPS file is composed of instances of three graphical 
objects: lines, arc, and text. Arc and lines objects have 
a start point, or object-handle, followed by zero or more 
points, or point-handles. Text has only an object-handle. 
The objects are positioned within a Cartesian plane, or 
universe, having 64K (-32K to +32K) points, or 
universe-units, on each axis. The universe is divided 
into 25 equal sized areas called regions. Regions are 
arranged in five rows of five squares each, numbered 1 to 
25 from the lower left of the universe to the upper right. 


Ged maps rectangular areas, called wendows, from the 
universe onto the display screen. Windows allow the 
user to view pictures from different locations and at 
different magnifications. The untverse-window is the 
window with minimum magnification, i.e., the window 
that views the entire universe. The home-window is the 
window that completely displays the contents of the 
display buffer. 


COMMANDS 


Ged commands are entered in stages. Typically each 
stage ends with a <er> (return). Prior to the final 
<er> the command may be aborted by typing rubout. 
The input of a stage may be edited during the stage 
using the erase and kill characters of the calling shell. 
The prompt * indicates that ged is waiting at stage L. 


Each command consists of a subset of the following 


fee 


stages: 


1. 


2. 


3. 


4. 


5. 
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Command line 


A command line consists of a command 
name followed by argument(s) followed by 
a <er>. A command name is a single 
character. Command arguments are either 
option(s) or a file-name. Options are 
indicated by a leading -—. 


Text Text is a sequence of characters terminated 
by an unescaped <cr>. (120 lines of text 
maximum.) 

Points Points is a sequence of one or more screen 
locations (maximum of 30) indicated either 
by the terminal crosshairs or by name. 
The prompt for entering points is the 
appearance of the crosshairs. When the 
crosshairs are visible, typing: 
sp (space) enters the current location as 

a point. The potnt is identified with 
a number. 

$n enters the previous potnt numbered n. 

>z labels the last point entered with the 
upper case letter z. 

$z enters the point labeled z. 

. establishes the previous points as the 
current potnts. At the start of a 
command the previous points are 
those locations given with the 
previous command. 

= _ echoes the current points. 

$.n enters the point numbered n from the 
previous points. 

# erases the last pornt entered. 

@ erases all of the points entered. 

Pivot The pivot is a single location, entered by 
typing <er> or by using the $ operator, 
and indicated with a *. 

Destination 


The destination is a single location entered 
by typing <er> or by using $. 


COMMAND SUMMARY 


In the summary, characters typed by the user are printed 


-2- 


GED(1G) 


in bold. Command stages are printed in italics. 
Arguments surrounded by brackets “‘[]’’ are optional. 
Parentheses ‘‘( )” surrounding arguments separated by 
“or”? means that exactly one of the arguments must be 
given. 


Construct commands: 


Arc [-echo,style, weight] points 

Box (-echo,style,weight] points 

Circle |—echo,style, weight} points 
Hardware _—[—echo] tezt points 

Lines [—-echo, style, weight] points 

Text [—angle,echo, height, mid-point, right- 


point,text,weight] text points 


Edit commands: 


Delete ( — (universe or view) or points ) 

Edit —angle,echo,height,style,weight] ( — 
universe or view) or points ) 

Kopy [—-echo, points,x] points pivot 
destination 

Move |—echo, points,x] points pivot 
destination 

Rotate [—angle,echo,kopy,x] points pivot 
destination 

Scale [-echo,factor,kopy,x] points pivot 
destination 


View commands: 
coordinates points 


erase 
new-display 
object-handles __( — (universe or view) or points ) 


point-handles ( — (labelled-points or universe 
or view) or points ) 


view ( — (home or universe or region) 
or [—x] ptvot destination ) 

x [—view] points 

zoom [—out] points 


Other commands: 
quit or Quit 


read 


set 


write 


!command 
? 


Options: 
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(—angle,echo, height ,mid-point,right- 
point,text, weight 
file-name |destination] 


|—angle,echo,factor, height, kopy,mid- 


point,points, 
right-point,style,text,weight,x] 


file-name 


Options specify parameters used to construct, edit, and 
view graphical objects. If a parameter used by a 
command is not specifed as an option, the default value 
for the parameter will be used (see set below). The 
format of command options is: 
—option [, option | 

where option is keyletier{value]. Flags take on the values 
of true or false indicated by + and — respectively. If no 
value is given with a flag, true is assumed. 


Object options: 
anglen 
echo 


factorn 
heightn 


kopy 
mid-point 


points 
right-point 


styletype 


Angle of n degrees. 


When true, echo additions to the 
display buffer. 


Scale factor is n percent. 


Height of text is nm universe-units 
(0<n< 1280). 


When true, copy rather than move. 


When true, mid-point is used to 
locate text string. 


When true, operate on _ points 
otherwise operate on objects. 


When true, right-point is used to 
locate tezt string. 


Line style set to one of following 
types: 


80 solid 

da dashed 

dd dot-dashed 
do dotted 
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ld long-dashed 


text When false, text strings are outlined 
rather than drawn. 


weighttype Sets line weight to one of following 


types: 
n narrow 
m medium 
b bold 
Area options: 
home Reference the home-window. 
out Reduce magnification. 
regionn Reference region n. 
universe Reference the universe-window. 
view Reference those objects currently in 
view. 
x Indicate the center of the referenced 
area. 


COMMAND DESCRIPTIONS 
Construct commands: 
Arc and Lines 

behave similarly. Each consists of a command line 
followed by points. The first potnt entered is the 
object-handle. Successive points are point-handles. 
Lines connect the handles in numerical order. Arc 
fits a curve to the handles (currently a maximum 
of 3 points will be fit with a circular arc; splines 
will be added in a later version). 


Box and Circle 

are special cases of Lines and Arc, respectively. 
Box generates a rectangle with sides parallel to the 
universe axes. A diagonal of the rectangle would 
connect the first point entered with the last point. 
The first potnt is the object-handle. Point-handles 
are created at each of the vertices. Circle 
generates a circular arc centered about the point 
numbered zero and passing through the last point. 
The circle’s object-handle coincides with the last 
point. A point-handle is generated 180 degrees 
around the circle from the object-handle. 


Text and Hardware 
generate text objects. Each consists of a command 
line, text and points. Text is a sequence of 
characters delimited by <er>. Multiple lines of 


she 
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text may be entered by preceding a cr with a 
backslash {i.e., \er). The Text command creates 
software generated characters. Each line of 
software text is treated as a separate tezt object. 
The first potnt entered is the object-handle for the 
first line of text. The Hardware command sends 
the characters in text uninterpreted to the 
terminal. 


Edit commands: 

Edit commands operate on portions of the display buffer 
called defined areas. A defined area is referenced either 
with an area option or interactively. If an area option is 
not given, the perimeter of the defined area is indicated 
by points. If no point is entered, a small defined area is 
built around the location of the <cr>. This is useful to 
reference a single potnt. If only one point is entered, the 
location of the <er> is taken in conjunction with the 
potnt to indicate a diagonal of a rectangle. A defined 
area referenced by points will be outlined with dotted 
lines. 


Delete 
removes all objects whose object-handle lies within 
a defined area. The universe option removes all 
objects and erases the screen. 


Edit modifies the parameters of the objects within a 
defined area. Parameters that can be edited are: 
angle angle of tezt 
height height of tezt 
style style of iines and are 
weight weight of lines, arc, and tezt. 


Kopy (or Move) 
copies (or moves) object- ane or point-handles 
within a defined area by the displacement from the 
ptvot to the destination. 


Rotate 
rotates objects within a defined area around the 
pivot. If the kopy flag is true then the objects are 
copied rather than moved. 


Scale 
For objects whose object handles are within a 
defined area, point displacements from the pivot 
are scaled by factor percent. If the kopy flag is 
true then the objects are copied rather than moved. 
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View commands: 
coordinates 


erase 


prints the location of point(s) in universe- and 
screen-units. 


clears the screen (but not the display buffer). 


new-display 


erases the screen then displays the display buffer. 


object-handles (or point-handles) 


view 


zoom 


labels object-handles (and/or point-handles) that 
lie within the defined area with O (or P). Point- 
handles identifies labeled points when the labelled- 
points flag is true. 


moves the window so that the universe point 
corresponding to the pivot coincides with the screen 
point corresponding to the destination. Options for 
home, universe, and region display particular 
windows in the universe. 


indicates the center of a defined area. Option view 
indicates the center of the screen. 


decreases (zoom out) or increases the magnification 
of the viewing window based on the defined area. 
For increased magnification, the window is set to 
circumscribe the defined area. For a decrease in 
magnification the current window is inscribed 
within the defined area. 


Other commands: 
quit or Quit 


read 


set 


write 


! 
. 


exit from ged. Quit responds with ? if the display 
buffer has not been written since the last 
modification. 


inputs the contents of a file. If the file contains a 
GPS it is read directly. If the file contains text it is 
converted into text object(s). The first line of a 
text file begins at destination. 


when given option(s) resets default parameters, 
otherwise it prints current default values. 


outputs the contents of the display buffer to a file. 
escapes ged to execute a CTIX system command. 
lists ged commands. 
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SEE ALSO 
gdev(1G), graphics(1G), sh(1), gps(4). 
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NAME 
get — get a version of an SCCS file 

SYNOPSIS 
et [—rSID] eae Phe [-xlist] [—wstring 
Senor [-k] {-e] [-1[p]] [-p] [-m] [-n] [-s] [-b 
—g} [—t]} file... 

DESCRIPTION 


Get generates an ASCII text file from each named SCCS 
file according to the specifications given by its keyletter 
arguments, which begin with —. The arguments may be 
specified in any order, but all keyletter arguments apply 
to all named SCCS files. If a directory is named, get 
behaves as though each file in the directory were 
specified as a named file, except that non-SCCS files (last 
component of the path name does not begin with s.) and 
unreadable files are silently ignored. If a name of —~ is 
given, the standard input is read; each line of the 
standard input is taken to be the name of an SCCS file to 
be processed. Again, non-SCCS files and unreadable files 
are silently ignored. 


The generated text is normally written into a file called 
the g-file whose name is derived from the SCCS file name 
by simply removing the leading s.; (see also FILES, 
below). 


Each of the keyletter arguments is explained below as 
though only one SCCS file is to be processed, but the 
effects of any keyletter argument applies independently 
to each named file. 


-rSID The SCCS JDentification string (SID) of the 
version (delta) of an SCCS file to be retrieved. 
Table 1 below shows, for the most useful 
cases, what version of an SCCS file is 
retrieved (as well as the SID of the version to 
be eventually created by delta(1) if the -e 
keyletter is also used), as a function of the 
SID specified. 

—ccutoff Cutoff date-time, in the form: 

YY[MM[DD[HH[MM{ISs]]|}| 

No changes (deltas) to the SCCS file which 
were created after the specified cutoff date- 
time are included in the generated ASCII text 
file. Units omitted from the date-time 
default to their maximum possible values; 
that is, —-c7502 is equivalent to 
~—c750228235959. Any number of non- 


—b 


—ilist 
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numeric characters may separate the various 
2-digit pieces of the cutoff date-time. This 
feature allows one to specify a cutoff date in 
the form: "—¢e77/2/2 9:22:25". Note that 
this implies that one may use the %E% and 
%U% identification keywords (see below) for 
nested gets within, say the input to a 
send(1C} command: 


COm aia. 


“Iget "-c%E% %U%" s.file 


Indicates that the get is for the purpose of 
editing or making a change (delta) to the 
SCCS file via a subsequent use of delta(1). 
The —e keyletter used in a get for a 
particular version (SID) of the SCCS file 
prevents further gets for editing on the same 
SID until delta is executed or the j (joint edit) 
flag is set in the SCCS file (see admin(1)). 
Concurrent use of get —e for different SIDs is 
always allowed. 


If the g-file generated by get with an —e 
keyletter is accidentally ruined in the process 
of editing it, it may be regenerated by re- 
executing the gef command with the —k 
keyletter in place of the —e keyletter. 


SCCS file protection specified via the ceiling, 
floor, and authorized user list stored in the 
SCCS file (see admin(1)) are enforced when 
the —e keyletter is used. 


Used with the —e keyletter to indicate that 
the new delta should have an SID in a new 
branch as shown in Table t. This keyletter is 
ignored if the b flag is not present in the file 
(see admin(1)) or if the retrieved delta is not 
a leaf delta. (A leaf delta is one that has no 
successors on the SCCS file tree.) 

Note: A branch delta may always be created 
from a non-leaf delta. 


A list of deltas to be included (forced to be 
applied) in the creation of the generated file. 
The list has the following syntax: 

<list> = <range> | <list> , <range> 
<range> ::= SID | SID — SID 

SID, the SCCS Identification of a delta, may 
be in any form shown in the “SID Specified”’ 
column of Table l. Partial SIDs are 
interpreted as shown in the “SID Retrieved”’ 
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—xlist 


-lip] 


—-p 


-m 


-n 


-t 
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column of Table 1. 


A list of deltas to be excluded (forced not to 
be applied) in the creation of the generated 
file. See the —i keyletter for the list format. 


Suppresses replacement of identification 
keywords (see below) in the retrieved text by 
their value. The —k keyletter is implied by 
the —e keyletter. 


Causes a delta summary to be written into an 
l-file. If —lp is used then an l-file is not 
created; the delta summary is written on the 
standard output instead. See FILES for the 
format of the I-file. 


Causes the text retrieved from the SCCS file 
to be written on the standard output. No g- 
file is created. All output which normally 
goes to the standard output goes to file 
descriptor 2 instead, unless the —s keyletter 
is used, in which case it disappears. 


Suppresses all output normally written on the 
standard output. However, fatal error 
messages (which always go to file descriptor 
2) remain unaffected. 


Causes each text line retrieved from the SCCS 
file to be preceded by the SID of the delta 
that inserted the text line in the SCCS file. 
The format is: SID, followed by a horizontal 
tab, followed by the text line. 


Causes each generated text line to be 
preceded with the %M%_ identification 
keyword value (see below). The format is: 
S%M% value, followed by a horizontal tab, 
followed by the text line. When both the 
—m and —n keyletters are used, the format 
is: %M% value, followed by a horizontal tab, 
followed by the -—m_ keyletter generated 
format. 


Suppresses the actual retrieval of text from 
the SCCS file. It is primarily used to generate 
an I-file, or to verify the existence of a 
particular SID. 


Used to access the most recently created 
(‘‘top”) delta in a given release (e.g., —r1), or 
release and level (e.g., ~r1.2). 
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—w string Substitute string for all occurrences of 
%w% when geting the file. 


—aseg-no. The delta sequence number of the SCCS file 
delta (version) to be retrieved (see gecelday ). 
This keyletter is used by the comd(1) 
command; it is not a _ generally useful 
keyletter, and users should not use it. If both 
the -r and —a keyletters are specified, the 
—a keyletter is used. Care should be taken 
when using the —a keyletter in conjunction 
with the —e keyletter, as the SID of the delta 
to be created may not be what one expects. 
The —r keyletter can be used with the —a 
and —e keyletters to control the naming of 
the SID of the delta to be created. 


For each file processed, get responds (on the standard 
output) with the SID being accessed and with the number 
of lines retrieved from the SCCS file. 


If the —e keyletter is used, the SID of the delta to be 
made appears after the SID accessed and before the 
number of lines generated. If there is more than one 
named file or if a directory or standard input is named, 
each file name is printed (preceded by a new-line) before 
it is processed. If the —i keyletter is used included deltas 
are listed following the notation ‘Included’; if the —x 
keyletter is used, excluded deltas are listed following the 
notation “Excluded”. 
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TABLE 1. Determination of SCCS Identification String 





sIp* —b Keyletter Other sID SID of Delta 

Specified Usedt Conditions Retrieved to be Created 

nonet no R defaults tomR mR.mL mR.(mL +1 

nonet yes R defaults tomR mR.mL mR.mL.(mB +1).1 

R no R> mR mR.mL R.1*** 

R no R= mR mR.mL mR.(mL +1 

R yes R > mR mR.mL mR.mL.(mB +1).1 

R yes R= mR mR.mL mR.mL.(mB +1).1 
R < mR and se 

R docs web eviat hR.mL hR.mL.(mB +1).1 
Trunk succ.# 

R - in release > R R.mL R.mL.(mB +1).1 
and R exists 

R.L no No trunk succ. R.L R(L+1 

R.L yes No trunk suce. R.L R.L.(mB +1).1 
Trunk succ. 

RL = intelese SRR R.L.(mB +1).1 

R.L.B no No branch suce. RLB.mS  R.L.B(mS+1 

R.L.B yes No branch suce. R.L.B.mS  R.L.(mB+1).1 

R.L.B.S no No branch succe. R.L.B.S R.L.B.(S +1 

R.L.B.S yes No branch succ. R.L.B.S R.L.(mB +1).1 

R.L.B.S - Branch succ. R.L.B.S R.L.(mB +1).1 

* “R?. S7, “BR”, and ‘“‘S” are the “‘release’’, “Jevel’’, 
“branch”, and ‘“‘sequence” components of the SID, 
respectively; ‘‘m’’ means ‘“‘maximum’’. Thus, for 
example, ‘“R.mL’’ means ‘the maximum level 
number within release R”; “R.L.(mB+1).1” means 
“the first sequence number on the new branch (i.e., 
maximum branch number plus one) of level L 
within release R’’. Note that if the SID specified is 
of the form “R.L”’, “R.L.B’’, or “R.L.B.S”’, each of 
the specified components must exist. 

** “hR” is the highest eztsting release that is lower 
than the specified, nonezistent, release R. 

*** This is used to force creation of the first delta in a 
new release. 

# Successor. 

t The —b keyletter is effective only if the b flag Cs 
admin(1)) is present in the file. An entry of — 
means “‘irrelevant”’. 

t This case applies if the d (default SID) flag is not 


present in the file. If the d flag ts present in the 
file, then the SID obtained from the d flag is 
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interpreted as if it had been specified on the 
command line. Thus, one of the other cases in this 
table applies. 


IDENTIFICATION KEYWORDS 
Identifying information is inserted into the text retrieved 
from the SCCS file by replacing tdentification keywords 
with their value wherever they occur. The following 
keywords may be used in the text stored in an SCCS file: 


Keyword Value 


%M% 


RI% 


MRM 
%L% 
%B% 
NS% 
RO% 
RH% 
%T% 
REM 


%G% 
RUM 
RY% 
YF % 
%P% 
%Q% 


%C% 


%LM% 
RwW% 


RAM 


Module name: either the value of the m flag 
in the file (see admin(1)), or if absent, the 
name of the SCCS file with the leading s. 
removed. 

SCCS identification Cr 
(MR%M.%L%.%B%.%S%) of the retrieved 
text. 

Release. 

Level. 

Branch. 

Sequence. 

Current date (YY/MM/DD). 

Current date (MM/DD/YY). 

Current time (HH:MM‘SS). 

Date newest applied delta was created 


YY/MM/DD). 
ate newest applied delta was created 
popes 
ime newest applied delta was created 
(HH:MM:SS). 


Module type: value of the t flag in the SCCS 
file (see admin(1)). 

SCCS file name. 

Fully qualified SCCS file name. 

The value of the q flag in the file (see 
admin(1)). 

Current line number. This keyword is 
intended for identifying messages output by 
the program such as “this should not have 
happened” type errors. It is not intended to 
be used on every line to provide sequence 
numbers. 

The 4-character string @(#) recognizable by 
what(1). 

A shorthand notation for constructing what(1) 
strings for CTIX system program files. 
We = RL%%M% < horizontal-tab > %1% 
Another shorthand notation for constructing 
what(1) strings for non-CTIX system program 


=6< 


FILES 
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files. 


NAM = NLBVY% %M% MI%%L% 


Several auxiliary files may be created by get. These files 
are known generically as the g-file, I-file, p-file, and z- 
file. The letter before the hyphen is called the tag. An 
auxiliary file name is formed from the SCCS file name: 
the last component of all SCCS file names must be of the 
form s.module-name, the auxiliary files are named by 
replacing the leading s with the tag. The g-file is an 
exception to this scheme: the g-file is named by 
removing the s. prefix. For example, s.xyz.c, the 
auxiliary file names would be xysz.c, lxyz.c, p.xyz.c, 
and #.xysz.c, respectively. 


The g-file, which contains the generated text, is created 
in the current directory (unless the —p keyletter is used). 
A g-file is created in all cases, whether or not any lines 
of text were generated by the get. It is owned by the 
real user. If the —k keyletter is used or implied its mode 
is 644; otherwise its mode is 444. Only the real user 
need have write permission in the current directory. 


The l-file contains a table showing which deltas were 
applied in generating the retrieved text. The I-file is 
created in the current directory if the —] keyletter is 
used; its mode is 444 and it is owned by the real user. 
Only the real user need have write permission in the 
current directory. 


Lines in the /-file have the following format: 


a. A blank character if the delta was 
applied; 
* otherwise. 

b. A blank character if the delta was 


applied or was not applied and ignored; 
* if the delta was not applied and was 
not ignored. 
c. A code indicating a “special’’ reason 
why the delta was or was not applied: 
“T’’: Included. 
“X”’: Excluded. 
“C”: Cut off (by a —c keyletter). 
Blank. 
SCCS identification (SID). 
Tab character. 
Date and time (in the form 
YY/MM/DD HH:MM:SS) of creation. 
Blank. 


r mmoe 


SEE ALSO 


GET(1) 


i. Login name of person who created delta. 


The comments and MR data follow’ on 
subsequent lines, indented one horizontal tab 
character. A blank line terminates each entry. 


The p-file is used to pass information resulting from a 
get with an —e keyletter along to delta. Its contents are 
also used to prevent a subsequent execution of get with 
an —e keyletter for the same SID until delta is executed 
or the joint edit flag, j, ie admin(1)) is set in the SCCS 
file. The p-file is created in the directory containing the 
SCCS file and the effective user must have write 
permission in that directory. Its mode is 644 and it is 
owned by the effective user. The format of the p-file is: 
the gotten SID, followed by a blank, followed by the SID 
that the new delta will have when it is made, followed 
by a blank, followed by the login name of the real user, 
followed by a blank, followed by the date-time the get 
was executed, followed by a blank and the —i keyletter 
argument if it was present, followed by a blank and the 
—x keyletter argument if it was present, followed by a 
new-line. There can be an arbitrary number of lines in 
the p-file at any time; no two lines can have the same 
new delta SID. 


The 2z-file serves as a lock-out mechanism against 
simultaneous updates. Its contents are the binary (2 
bytes) process ID of the command (i.e., get) that created 
it. The z-file is created in the directory containing the 
SCCS file for the duration of get. The same protection 
restrictions as those for the p-file apply for the z-file. 
The z-file is created mode 444. 


admin(L), delta(1), help(1), prs(1), et) secsfile(4). 
CTIX Programmer’s Guide, Section 9 


DIAGNOSTICS 


BUGS 


Use help(1) for explanations. 


If the effective user has write permission (either 
explicitly or ampliciey) in the directory containing the 
SCCS files, but the real user does not, then only one file 
may be named when the —e keyletter is used. 


GETOPT(1) 


NAME 

getopt — parse command options 
SYNOPSIS 

set —— ‘getopt optstring $** 
DESCRIPTION 


Getopt is used to break up options in command lines for 
easy parsing by shell procedures and to check for legal 
options. Optstring is a string of recognized option letters 
(see getopt{3C)); if a letter is followed by a colon, the 
option is expected to have an argument which may or 
may not be separated from it by white space. The 
special option —— is used to delimit the end of the 
options. If it is used explicitly, getopt will recognize it; 
otherwise, getopt will generate it; in either case, getopt 
will place it at the end of the options. The positional 
parameters ($1 $2...) of the shell are reset so that each 
option is preceded by a — and is in its own positional 
parameter; each option argument is also parsed into its 
own positional parameter. 


EXAMPLE 
The following code fragment shows how one might 
process the arguments for a command that can take the 


options a or b, as well as the option o, which requires an ( 
argument: - 
set —~- ‘getopt abo: $** 
if {[ $? !=0 i | 
then , 
echo $USAGE 
exit 2 
fi 
for i in $* 
do 
case $i in 
-a| —-b) FLAG=$i; shift;; 
—o) OARG=$2; shift 2;; 
--) shift; break;; 
esac 
done 


This code will accept any of the following as equivalent: 


cmd —aoarg file file 

cmd —a —o arg file file 
cmd -oarg —a file file 
cmd —a —oarg —- file file 


SEE ALSO 
sh(1), getopt(3C). 
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DIAGNOSTICS 
Getopt prints an error message on the standard error 
when it encounters an option letter not included in 
optstring. 


GETTY( 1M) 


NAME 
getty -— set terminal type, modes, speed, and line 
discipline 
SYNOPSIS 
etc/getty | —h ] | —t timeout | line | speed [ type 
linedise r | 
/ete/getty —c file 


DESCRIPTION 

Getty is a program that is invoked by tntt(1M). It is the 
second process in the series, (intt-getty-login-shell) that 
ultimately connects a user with the CTIX system. 
Initially getty generates a system identification message 
from the values returned by the uname(2) system call. 
Then, if /etc/issue exists, it outputs this to the user’s 
terminal, followed finally by the login message field for 
the entry it is using from /ete/gettydefs. Getty reads 
the user’s login name and invokes the /ogin(1) command 
with the user’s name as argument. While reading the 
name, getty attempts to adapt the system to the speed 
and type of terminal being used. 


Line is the name of a tty line in /dev to which getty is 
to attach itself. Getty uses this string as the name of a 
file in the /dev directory to open for reading and 
writing. Unless getty is invoked with the —h flag, getty 
will force a hangup on the line by setting the speed to 
zero before setting the speed to the default or specified 
speed. The -t flag plus timeout in seconds, specifies 
that getty should exit if the open on the line succeeds 
and no one types anything in the specified number of 
seconds. The optional second argument, speed, is a label 
to a speed and tty definition in the file /ete/gettydefs. 
This definition tells getty at what speed to initially run, 
what the login message should look like, what the inital 
tty settings are, and what speed to try next should the 
user indicate that the speed is inappropriate. (by typing 
a <break> character). The default speed is 9600 baud. 
The optional third argument, type, is a character string 
describing to getty what type of terminal is connected to 
the line in question. Getty understands the following 


types: 
none default 
vt61 DEC vt61 
vt100 DEC vt100 
hp45 Hewlett-Packard HP45 
c100 Concept 100 


The default terminal is none; i.e., any crt or normal 
terminal unknown to the system. Also, for terminal type 


opts 
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to have any meaning, the virtual terminal handlers must 
be compiled into the operating system. They are 
available, but not compiled in the default condition. 
The optional fourth argument, linedisc, is a character 
string describing which line discipline to use in 
communicating with the terminal. Again the hooks for 
line disciplines are available in the operating system but 
there is only one presently available, the default line 
discipline, LDISCO. 


When given no optional arguments, getty sets the speed 
of the interface to 9600 baud, specifies that raw mode is 
to be used (awaken on every character), that echo is to 
be suppressed, either parity allowed, newline characters 
will be converted to carriage return-line feed, and tab 
expansion performed on the standard output. It types 
the login message before reading the user’s name a 
character at a time. If a null character (or framing 
error) is received, it is assumed to be the result of the 
user pushing the “break” key. This will cause getty to 
attempt the next speed in the series. The series that 
getty tries is determined by what it finds in 
/ete/gettydefs. 


The user’s name is terminated by a new-line or carriage- 
return character. The latter results in the system being 
set to treat carriage returns appropriately (see toctl(2)). 


The user’s name is scanned to see if it contains any 
lower-case alphabetic characters; if not, and if the name 
is non-empty, the system is told to map any future 
upper-case characters into the corresponding lower-case 
characters. 


In addition to the standard UNIX system erase and kill 
characters (# and @), getty also understands \b and *U. 
If the user uses a \b as an erase, or code—U as a kill 
character, getty sets the standard erase character and/or 
kill character to match. 


Getty also understands the ‘“‘standard” ESS protocols for 
erasing, killing and aborting a line, and terminating a 
line. If getty sees the ESS erase character, _, or kill 
character, $, or abort character, &, or the ESS line 
terminators, / or !, it arranges for this set of characters 
to be used for these functions. 


Finally, login is called with the user’s name as an 
argument. Additional arguments may be typed after the 
login name. These are passed to login, which will place 
them in the environment (see login(1)). 


FILES 
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A check option is provided. When getty is invoked with 
the —c option and file, it scans the file as if it were 
scanning /ete/gettydefs and prints out the results to 
the standard output. If there are any unrecognized 
modes or improperly constructed entries, it reports these. 
If the entries are correct, it prints out the values of the 
various flags. See toctl(2) to interpret the values. Note 
that some values are added to the flags automatically. 


/etc/gettydefs 
etc /issue 


SEE ALSO 


BUGS 


ct(1C), init(1M), —login(1), —_ioctl(2), —_ gett ydef's(4), 
inittab(4), tty(7). 


While getty does understand simple single character 
quoting conventions, it is not possible to quote the 
special control characters that getty uses to determine 
when the end of the line has been reached, which 
protocol is being used, and what the erase character is. 
Therefore it is not possible to login via getty and type a 
#, @, /, !, _, backspace, “U, “D, or & as part of your 
login name or arguments. They will always be 
interpreted as having their special meaning as described 
above. 


NAME 


GRAPH(1G) 


graph — draw a graph 


SYNOPSIS 


graph [ options ] 


DESCRIPTION 


Graph with no options takes pairs of numbers from the 
standard input as abscissas and ordinates of a graph. 
Successive points are connected by straight lines. The 
graph is encoded on the standard output for display by 
the tplot(1G) filters. 


If the coordinates of a point are followed by a non- 
numeric string, that string is printed as a label beginning 
on the point. Labels may be surrounded with quotes “, 
in which case they may be empty or contain blanks and 
numbers; labels never contain new-lines. 


The following options are recognized, each as a separate 
argument: 


—a Supply abscissas automatically (they are 
missing from the input); spacing is given by 
the next argument (default 1). A second 
optional argument is the starting point for 
automatic abscissas (default 0 or lower limit 
given by —x). 


-b Break (disconnect) the graph after each label 
in the input. 

—¢ Character string given by next argument is 
default label for each point. 

-g Next argument is grid style, O no grid, 1 
frame with ticks, 2 full grid (default). 

-l Next argument is label for graph. 

-m Next argument is mode (style) of connecting 


lines: 0 disconnected, 1 connected (default). 
Some devices give distinguishable line styles 
for other small integers (eg., the 
TEKTRONIX 4014: 2=—dotted, 3=dash-dot, 
=short-dash, 5==long-dash). 

-s Save screen, do not erase before plotting. 

-x(1] — If Lis present, x axis is logarithmic. Next 1 
(or 2) arguments are lower (and upper) z 
limits. Third argument, if present, is grid 
spacing on z axis. Normally these quantities 
are determined automatically. 

~y [1] Similarly for y. 


-h Next argument is fraction of space for height. 
—w Similarly for width. 
-r Next argument is fraction of space to move 


right before plotting. 
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-u Similarly to move up before plotting. 

—t Transpose horizontal and vertical axes. 
(Option —x now applies to the vertical axis.) 

A legend indicating grid range is produced with a grid 

unless the —s option is present. If a specified lower limit 

exceeds the upper limit, the axis is reversed. 


SEE ALSO 


BUGS 


graphics(1G), spline(1G), tplot(1G). 


Graph stores all points internally and drops those for 
which there is no room. 

Segments that run out of bounds are dropped, not 
windowed. 

Logarithmic axes may not be reversed. 


GRAPHICS(1G) 


NAME 
graphics — access graphical and numerical commands 


SYNOPSIS 
graphics | -r | 

DESCRIPTION 
Graphics prefixes the path name /usr/bin/graf to the 
current $PATH value, changes the primary shell prompt 
to *, and executes a new shell. The directory 
/usr/bin/graf contains all of the Graphics subsystem 
commands. If the —r option is given, access to the 
graphical commands is created in a_ restricted 
environment; that is, $PATH is set to 

:/usr/bin/graf:/rbin:/usr /rbin 

and the restricted shell, rsh, is invoked. To restore the 
environment that existed prior to issuing the graphics 
command, type EOT (control-d on most terminals). To 
logoff from the graphics environment, type quit. 


The command line format for a command in graphics is 
command name followed by arguments). An argument 
may be a file name or an option string. A file name is 
the name of any CTIX system file except those beginning 
with —. The file name — is the name for the standard 
input. An option string consists of — followed by one or 
more option(s). An optton consists of a keyletter possibly 
followed by a value. Options may be separated by 
commas. 
The graphical commands have been partitioned into four 
groups. 
Commands that manipulate and plot numerical 
data; see stat(1G). 
Commands that generate tables of contents; see 
toc(1G). 
Commands that interact with graphical devices; 
see gdev(1G) and ged(1G). 
A collection of graphical utility commands; see 
gutil(1G). 
A list of the graphics commands can be generated by 
typing whatis in the graphics environment. 


SEE ALSO 
gdev(1G), ged(1G), gutil(1G), stat(1G), toc(1G), gps(4). 
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NAME 

greek — select terminal filter 
SYNOPSIS 

greek | —Tterminal | 
DESCRIPTION 


Greek is a filter that reinterprets the extended character 
set, as well as the reverse and half-line motions, of a 
128-character TELETYPE Model 37 terminal (which is 
the nroff(1) default terminal) for certain other terminals. 
Special characters are simulated by overstriking, if 
necessary and possible. If the argument is omitted, 
reek attempts to use the environment variable $TERM 
lise environ(5)). The following terminals are recognized 


currently: 
300 DASI 300. 
300-12 DASI 300 in 12-pitch. 
300s DASI 300s. 
300s-12 DASI 300s in 12-pitch. 
450 DASI 450. 
450-12 DASI 450 in 12-pitch. 
1620 Diablo 1620 (alias DASI 450). 
1620-12 Siete 1620 (alias DASI 450) in 12- 
pitch. 
2621 Hewlett-Packard 2621, 2640, and 
2645. 
2640 Hewlett-Packard 2621, 2640, and 
2645. 
2645 Hewlett-Packard 2621, 2640, and 
2645. 
4014 TEKTRONIX 4014. 
hp Hewlett-Packard 2621, 2640, and 
2645. 
tek TEKTRONIX 4014. 
FILES 
/usr/bin/300 
/usr/bin /300s 
/usr/bin/4014 
/usr/bin/450 
/usr/bin/hp 
SEE ALSO 


300(1), 4014(1), 450(1), eqn(1), hp(1), mm(1), nroff(1), 
tplot(1G), environ(5), term(5). 


ED(1) 


by the replacement if the global replacement 
indicator g appears after the command. If the 
global indicator does not appear, only the first 
occurrence of the matched string is replaced. It 
is an error for the substitution to fail on all 
addressed lines. Any character other than space 
or new-line may be used instead of / to delimit 
the RE and the replacement; . is left at the last 
line on which a substitution occurred. See also 
the last paragraph before FILES below. 


An  ampersand (& appearing in the 
replacement is replaced by the string matching 
the RE on the current line. The special meaning 
of & in this context may be suppressed by 
preceding it by \. As a more general feature, 
the characters \n, where n is a digit, are 
replaced by the text matched by the n-th 
regular subexpression of the specified RE 
enclosed between \( and \). When nested 
parenthesized subexpressions are present, n is 
determined by counting occurrences of \( 
starting from the left. When the character % 1s 
the only character in the replacement, the 
replacement used in the most recent substitute 
command is used as the replacement in the 
current substitute command. The % loses its 
special meaning when it is in a replacement 
string of more than one character or is preceded 
by a \ 
A line may be split by substituting a new-line 
character into it. The new-line in the 
replacement must be escaped by preceding it by 
\. Such substitution cannot be done as part of a 
g or v command list. 

(.,-)ta , 
This command acts just like the m command, 
except that a copy of the addressed lines is 
placed after address a (which may be 0); . is left 
at the last line of the copy. 


The undo command nullifies the effect of the 
most recent command that modified anything in 
the buffer, namely the most recent a, c, d, g, ?, 
j,m, 7, 8, t, v, G, or V command. 


(1,$ Were ey command list 
his command is the same as the global 
command g except that the command list is 


-10- 


ED(1) 


executed with . initially set to every line that 
does not match the RE. 
(1, 8)V/RE/ 
his command is the same as the interactive 
global command G except that the lines that are 
marked during the first step are those that do 
not match the RE. 


(1, $ )w file 

The write command writes the addressed lines 
into the named file. If the file does not exist, it 
is created with mode 666 (readable and writable 
by everyone), unless your umask setting (see 
sh(1)) dictates otherwise. The currently- 
remembered file name is not changed unless file 
is the very first file name mentioned since ed 
was invoked. If no file name is given, the 
currently-remembered file name, if any, is used 
(see e and f commands); . is unchanged. If the 
command is successful, the number of characters 
written is typed. If file is replaced by !, the rest 
of the line is taken to be a shell (sh(1)) 
command whose standard input is the addresse 

lines. Such a shell command is not remembered 
as the current file name. 


($)= 
The line number of the addressed line is typed; . 
is unchanged by this command. 


!shell command 
The remainder of the line after the ! is sent to 
the CTIX System shell (sh(1)) to be interpreted 
as a command. Within the text of that 
command, the unescaped character % is 
replaced with the remembered file name; if a ! 
appears as the first character of the shell 
command, it is replaced with the text of the 
previous shell command. Thus, !! will repeat the 
last shell command. If any expansion is 
performed, the expanded line is echoed; . is 
unchanged. 

(.+1 )<new-line > 
An address alone on a line causes the addressed 
line to be printed. A _ new-line alone is 
equivalent to .+1p; it is useful for stepping 
forward through the buffer. 

If an interrupt signal (ASCII DEL or BREAK) is sent, ed 

prints a ? and returns to tts command level. 
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iv — initialize and maintain volume 


SYNOPSIS 


iv —iuostdwlvq spectal [ descriptionfile | 


DESCRIPTION 


Iv initializes and maintains a disk volume. Special and 
descriptionftle specify the disk and a description file for 
it; these are described below. Jv does one of five 
operations, specified by the following options: 


-i Completely initialize a volume. This consists of 
five phases: 
1. Initialize tv’s internal Volume Home 


Block, based on deseriptionfile and the 
disk type. If the disk can support bad 
block handling (all types, except floppy 
disks on MiniFrame systems), create an 
internal Bad Block Table. Put bad 
block data from descriptionfile and 
volume’s existing Bad Block Table (if 
any) in internal Bad Block Table. 


Format medium. 


Perform a surface check. If the disk can 
support bad block handling, add bad 
blocks to the Bad Block Table. If the 
disk cannot support bad block handling, 
the first bad spot causes the disk to be 
rejected. 


Write out the Volume Home Block. 
This has the effect of dividing the 
volume into slices (partitions). 


Allocate and write out the files that 
share the Reserved Area (slice 0) with 
the Volume Home Block. If the disk can 
support bad block handling, one of these 
files is the Bad Block Table. Other files 
are specified in descriptionfile. 


—u Update the Volume Home Block. This is the 
same as —i, except that the second and third 
phases (medium formatting and surface check) 
are skipped. 

ae) Output a Volume Home Block and partition 0 to 
any file; requires a descriptionfile. The following 
command produces a dump tape: 


File 
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iv -o /dev/rmt0 /usr/lib/iv/desc.tdump 


-s Surface test. Any bad blocks discovered are 
added to the bad block table. 


—t Tell volume description. Display volume home 
block in human-readable form. No description 
file is needed. The volume’s contents are not 
affected. 


—d Description file display. A description file that 
describes the current state of the volume is 
written to the standard output. If the Reserved 
Area contains a loader, the loader keyword’s 
value is written as /usr/lib/iv/loader. If the 
Reserved Area contains a down load image area, 
the Down Load Area Description lists files whose 
names are of the form 


/usr /lib/iv/wszzrz.yyy 
where rrr is the numeric device identification; 
and yyy is 422 if rrz is even, 232 if xrz is odd. 
The -f option, equivalent to —u, is provided for 
compatibility with older versions of tv. It should not be 
used, as it may disappear in future releases. 


In addition to the single operation option (—i, —u, —s, 

—t, or —d) you can specify any or all of the following 

options: 

-v Verbose display output. If the display includes 
the Volume Home Block, also include the bad 
block table. 


—l A normal surface test consists of a single pass 
over the disk; —I specifies ten passes. 


—Ww A normal surface test pass consists of a read 
pass; —w specifies a write pass before each read 
pass. 

-q Print the size of the disk (in megabytes). 

Parameters 


Spectal is the character special file for slice zero on the 
drive. This name takes the form /dev/rdsk/cndts0, 
where n is the controller number and ¢ is the drive 
number. 


Descriptionfile is a text file that describes the volume. 
It is required by the —i and —u options. The description 
file consists of five parts: 

° general description 

° reserved area description 
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° bad blocks description 
e partition table description 
e down load area description 


Each description is separated from the next by a line 
that contains only a single dollar sign ($). Specifics for 
each of the five descriptions are given under separate 
headings below. 


General Description 


Each line in the General Description begins with a 
keyword. Some keywords are followed by values; the 
value is separated from the keyword by spaces or tabs. 
For example: 


ecc 
cylinders 1024 


Each keyword is only used once. Here are the valid 
keywords. 


type Mandatory, unless the volume is already 
initialized in the appropriate format. 
Value is disk type: ‘SHD” for onboard 
ST506 hard disk, “RD” for RAM disk, 
“V3200” for SMD controller, and “FD” 
for floppy disk (MiniFrame only). 


name Mandatory, unless the volume is already 
initialized in the appropriate format. 
Value is the volume name. Any 
characters except spaces or tabs are 
permitted in the volume name; the serial 
number of the disk is the recommended 
volume name. The actual name in the 
Volume Home Block is always exactly six 
characters; tv right truncates names that 
are too long and right pads with nulls 
names that are too short. 


cylinders Mandatory, unless the volume is already 
initialized in the appropriate format. 
Value is the number of cylinders on the 
disk. 


heads Mandatory, unless the volume is already 
initialized in the appropriate format. 
Value is the number of heads on the disk. 


sectors Mandatory, unless the volume is already 
initialized in the appropriate format. 
Value is the number of physical sectors 
per track. 





formatextra 


steprate 


exchangeable 


hitech 


precomp 


ecc 
enetaddr 


gapl 
gap2 
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The SMD drive is formatted with an extra 
sector on each track. (This sector is 
ignored by CTIX but is required for some 
disk drives, notably the Eagle-XP.) 


Mandatory for ST506, unless the volume 
is already initialized in the appropriate 
format. Value is a number that is passed 
to the disk controller. The normal 
steprate for ST506 drives is 14; 0 can be 
used for slower drives. See the disk 
manufacturer’s documentation for further 
information. 


If this keyword is present, the disk can be 
removed from its drive. 


(ST506 drives only) If this keyword is 
present, the reduced write current line to 
the disk is used for head-select bit 3 to 
allow more than eight heads. 


(ST506 drives only) The value is c/16, 
where c is the cylinder at which precom- 
pensation should start. See the disk 
manufacturer’s documentation for further 
information. 


The disk has been prepared to function in 
ECC mode. 


(MiniFrame only) Ethernet address of the 
machine (boot drive only). 


Gap size for SMD drives. See the disk 
manufacturer’s documentation for further 
information. 


Reserved Area Description 


5/86 


The Reserved 


Area Description describes the files that 


share slice zero with the volume home block. Each line 
in the Reserved Area Description consists of a keyword 
followed by one or more parameters; one or more tabs or 
spaces separates keywords and parameters from each 
other. Here are the valid keywords and their meanings. 
(A logical block is 1024 bytes long.) 


loader 


Describes the loader area. The first, 
mandatory, parameter is the full 
pathname of an a.out file to put in the 
loader area. The second, optional, 
parameter is the size of the loader area 
in logical blocks. If the second 
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parameter is missing, the size of the 
a.out file is used. 


badblocktable 

Describes the bad block table. The first, 
mandatory, parameter is the size of the 
bad block table in logical blocks. The 
second, optional, parameter is only used 
when an_ existing bad block table 
contains errors; this parameter is 
“empty” to clear the bad block table, 
missing otherwise. 


dump Describes area to contain dump after 
crash. The only, mandatory, parameter, 
specifies the size of the dump area in 
logical blocks. 


downloadarea 

Describes area to contain system images 
for downloading. The only, mandatory, 
parameter, specifies the size of the 
download area in logical blocks. (The 
files actually put in this area are 
described separately. See the Down 
Load Area Description heading, below.) 


All lines valid for the Reserved Area Description are 
optional. However, the bad block table is mandatory on 
a volume which supports bad block handling; the loader 
area is mandatory on a volume which is to hold an 
operating system; and a dump area is recommended on a 
volume which is to hold an operating system. 


Bad Block Description 


5/86 


The Bad Block Description explicitly specifies up to 889 
bad blocks to be added to the bad block table. Iv 
merges specified bad block information with information 
already in the bad block table (if there already is one) 
and bad block information discovered through the 
surface test. 


Each bad block entry is a single line. There are two 
forms: 


8 
where ¢ is a sector number; 
chb 


where ¢ is a cylinder number, A is a head number, and 
is a byte number. Both forms condemn a single sector, 
the second the sector that contains the specified byte. 
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The last sector on each track serves as a bad block 
alternate. Jv chooses the alternates in a way that 
minimizes extra seeking for alternate blocks. 


Partition Table Description 


5/86 


The Partition Table Description specifies where the slices 
(partitions) on the disk are to begin and end. Each line 
in the Description specifies the starting logical block of a 
slice. Start blocks must be on even boundaries. Except 
for overlapping partitions, slices must be listed in 
ascending numeric order, and the beginning of a slice 
defines the end of the previous slice. 


If necessary, overlapping partitions can be specified. A $ 
following any block number indicates that the slice 
extends to the end of the disk, beyond the next boundary 
number. Any slice with a starting block number that is 
larger than its successor must extend to the end of the 
disk (and must therefore be followed by the $ 
parameter). 


For example, the following description specifies five 
slices; the fifth slice extends from the second slice to the 


end of the disk: 
0 


16 
20016 

40016 $ 
16 $ 


The following example is also possible, although of 
doubtful utility: 
0 


16 
20016 $ 
40016 $ 
16 
30016 $ 


In this example six slices are specified. The third, 
fourth, and sixth slices extend to the end of the disk. 
The fifth slice, however, starts at 16 and ends at 30015 
(inclusive); it includes all the second slice, but only part 
of the third slice. 


The first logical block boundary number in the 
Description must always be 0. The last slice in the 
Description always extends to the end of the disk ($ is 
optional). 

Note: Do not use Partition Table Descriptions 
from other versions of CTIX that specify 
partitions by track numbers, rather than by 
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logical block boundaries. 
There can be at most 16 slices on a disk. 


It is a fatal error to specify a slice 1 that does not leave 
enough room in slice 0 for the Volume Home Block and 
the slice 0 files. 


Down Load Area Description 


The Down Load Area Description specifies system images 
to be included in the Down Load Area. Each line in the 
Description consists of a numeric device identification, 
the size of the system image in logical blocks, and the 
full path name of the file to be copied into the down 
load area; the three parts of the line are separated by 
one or more spaces or tabs. 


EXAMPLES 
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Here is an example of a disk description file for a 
nonbootable disk where the bad block tables are omitted. 


# MAXTOR 85 MB disk 
HD 


type 

name Serno 

cylinders 1024 

heads 8 

sectors 17 

steprate 14 

hitech 

ecc 

$ 

$ 

0 

8 

$ 

$ 

The following file describes a bootable SMD. 

type V3200 

name Serno 

cylinders 1489 

heads 11 

sectors 33 

ecc 

gapl 16 
ap2 16 

badblocktable 3 

dump 1024 

downloadarea 300 

oe /usr/lib/iv /loader 

off 
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$ 

0 

1360 
17360 
25360 
45360 
85360 
125360 
165360 $ 


$ 
100 /usr/lib/iv/ws100.422 
Aa /usr /lib/iv /ws200.422 


The following file describes a bootable Hitachi drive. 
HD 


type 

name Serno 
cylinders 823 
heads 10 
sectors 17 
steprate 14 
hitech 


ecc 


badblocktable 1 

dump 1024 
downloadarea 300 

ae /usr/lib/iv/loader 


$ 

0 
1346 
17730 
25922 
46402 
$ 


100 /usr/lib/iv/ws100.422 
- /usr/lib/iv /ws200.422 
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The following file describes a drive without a dump area. 


type 

name Serno 
cylinders 645 
heads 7 
sectors 17 
steprate 14 
precomp 86 
hitech 

ecc 


$ 

badblocktable 1 

downloadarea 300 

oe /usr/lib/iv/loader 


$ 

0 

328 
12328 
18328 $ 
$ 


100 /usr/lib/iv /ws100.422 
on /usr/lib/iv/ws200.422 


/dev/rdsk/* — disk character special files 
/usr/lib/iv/desc.* — prototype description files. 


SEE ALSO 


update(1), disk(7). 

MightyFrame Admintstrator’s Reference Manual. 
MintF'rame Administrator’s Manual. 

“‘WD2010-05 Winchester Disk Controller” in Storage 
Management Products Handbook. Irvine, Calif.: Western 
Digital Corp., 1984. 


WARNINGS 
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The —i, —u, and —s operations are dangerous or fatal to 
existing volume data. Always precede these operations 
with a backup. 

When a new bad block is itself an alternate block, iv 
may produce messages that appear spurious but are 
actually correct. If the bad block is already in use as an 
alternate, the ‘“‘added bad block”? message can appear 
twice for one block. 


Do not run mkfs(1M) on an overlapping partition. 


NAME 
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join — relational database operator 


SYNOPSIS 


join [ options | file1 file2 


DESCRIPTION 


Join forms, on the standard output, a join of the two 
relations specified by the lines of filed and file2. If filet 
is —, the standard input is used. 


Filet and file2 must be sorted in increasing ASCII 
collating sequence on the fields on which they are to be 
joined, normally the first in each line. 


There is one line in the output for each pair of lines in 
filel and file2 that have identical join fields. The 
output line normally consists of the common field, then 
the rest of the line from ftle1, then the rest of the line 
from file2. 


The default input field separators are blank, tab, or 
new-line. In this case, multiple separators count as one 
field separator, and leading separators are ignored. The 
default output field separator is a blank. 


Some of the below options use the argument n. This 
argument should be a * or a 2 referring to either file1 or 
file2, respectively. The following options are recognized: 


-~an In addition to the normal output, produce a line 
for each unpairable line in file n, where n is 1 or 
2: 


-es Replace empty output fields by string s. 


—jn m Join on the mth field of file n. If n is missing, 
use the mth field in each file. Fields are 
numbered starting with 1. 


—o list Each output line comprises the fields specifed in 
list, each element of which has the form n.m, 
where n is a file number and m is a field 
number. The common field is not printed unless 
specifically requested. 


te Use character ¢ as a separator (tab character). 
Every appearance of c¢ in a line is significant. 
The character c is used as the field separator for 
both input and output. 


EXAMPLE 


The following command line will join the password file 
and the group file, matching on the numeric group ID, 
and outputting the login name, the group name and the 
login directory. It is assumed that the files have been 
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sorted in ASCII collating sequence on the group ID fields. 
join —jl 4 —j2 3 -0 1.1 2.11.6 —t: /etc/passwd 
/etc/group 


SEE ALSO 


BUGS 


awk(1), comm(1), sort(1), uniq(1). 


With default field separation, the collating sequence is 
that of sort —b; with —t, the sequence is that of a plain 
sort. 


The conventions of join, sort, comm, untq and awk(1) 
are wildly incongruous. 


Filenames that are numeric may cause conflict when the 
-o option is used right before listing filenames. 


cae 
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kill - terminate a process 


SYNOPSIS 


kill [ —signo | PID ... 


DESCRIPTION 


Kill sends signal 15 (terminate) to the specified 
processes. This will normally kill processes that do not 
catch or ignore the signal. The process number of each 
asynchronous process started with & is reported by the 
Shell (unless more than one process is started in a 
pipeline, in which case the number of the last process in 
the pipeline is reported). Process numbers can also be 
found by using ps(1). 

The details of the kill are described in fill(2). For 
example, if process number 0 is specified, all processes in 
the process group are signaled. 


The killed process must belong to the current user unless 
he is the super-user. 


If a signal number preceded by — is given as first 
argument, that signal is sent ae of terminate (see 
signal(2)). In particular “kill -9 .. .” is a sure kill. 


SEE ALSO 


ps(1), sh(1), kill(2), signal(2). 


KILLALL (1M) 


killall — kill all active processes 


SYNOPSIS 
/ete/killall [ signal | 

DESCRIPTION 
Killall is a procedure used by /ete/shutdown to kill all 
active processes not directly related to the shutdown 
procedure. 
Killall is chiefly used to terminate all processes with open 
files so that the mounted file systems will be unbusied 
and can be unmounted. 


Killall sends signal (see kill(1)) to all remaining processes 
not belonging to the above group of exclusions. If no 
signal is specified, a default of 9 is used. 


FILES 
/etc/shutdown 


SEE ALSO 
fuser(1M), kill(1), ps(1), shutdown(1M), signal(2). 
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NAME 

Id — link editor for common object files 
SYNOPSIS 

Id [-e Hi | (-f fill] a al (-r] [—s| [-t 





—o outfile] |[-u symnamej [—L dir] {[-x| {~Z 
—n]} [-F} el Lvs num] [—G} ca itaeine 


-M 
-N 
DESCRIPTION 

The /d command combines several object files into one, 
performs relocation, resolves external symbols, and 
supports symbol table information for symbolic 
debugging. In the simplest case, the names of several 
object programs are given, and /d combines them, 
producing an object module that can either be executed 
or used as input for a subsequent Id run. The output of 
ld is left in a.out. This file is executable if no errors 
occurred during the load. If any input file, filename, is 
not an object file, /d assumes it is either an ASCII file 
containing link editor directives or an archive library. 


If any argument is a library, it is searched exactly once 
at the point it is encountered in the argument list. Only 
those routines defining an unresolved external reference 
are loaded. The library (archive) symbol table (see 
ar(4)) is searched sequentially with as many passes as are 
necessary to resolve external references which can be 
satisfied by library members. Thus, the ordering of 
library members is unimportant. 
The following options are recognized by Id. 
—e epsym 
Set the default entry point address for the 
output file to be that of the symbol epsym. 


~f fill Set the default fill pattern for ‘“‘holes’”’ within an 
output section as well as initialized 6ss sections. 
The argument fill is a two-byte constant. 

—Iz Search a library named libz.a, where z is up to 
nine characters. A library is searched when its 
name is encountered, so the placement of a —1 is 
significant. By default, libraries are located in 


/lib 
and 
/usr /lib. 
However, if the shell variable LIBROOT is set, 


the value of LIBROOT is prepended to /lib and 
/usr/lib before searching the libraries. 


aps 


—-m 
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Produce a map or listing of the input/output 
sections on the standard output. 


—o outfile 


—-F 


-t 


Produce an output object file by the name 
outfile. The name of the default object file is 
a.out. 

Retain relocation entries in the output object 
file. Relocation entries must be saved if the 
output file is to become an input file in a 
subsequent Id run. The link editor will not 
complain about unresolved references, and the 
Output file will not be executed. 


Strip line number entries and symbol table 
information from the output object file. 


Turn off the warning about multiply-defined 
symbols that are not the same size. 


—u symname 


~x 


~Z 


—L dir 


—~M 


~N 


Enter symname as an undefined symbol in the 
symbol table. This is useful for loading entirely 
from a library, since initially the symbol table is 
empty and an unresolved reference is needed to 
force the loading of the first routine. 


Do not preserve local (non.-gleb)) symbols in the 
output symbol table; enter only external and 
static symbols. This option saves some space in 
the output file. 


Do not bind anything to address zero. This 
option will allow runtime detection of null 
pointers. 


Change the algorithm of searching for libz.a to 
look in dtr before looking in /lib. 


Output a message for each multiply-defined 
external definition. However, if the objects 
being loaded include debugging information, 
extraneous output is produced (see the —g option 
in ce(1)). 

Put the data section immediately following the 
text in the output file. The result is a plain 
executable file, indicated by magic number 0407 
in the operating system header. 


Put the data section at the next segment 
boundary following the text section. The result 
is a shared text file, indicated by magic number 
0410 in the operating system header. 
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Like —n but permits demand paged execution. 
This type of file is indicated by magic number 
0413 in the operating system header. 


Like —z but takes less disk space and can page 
faster into memory. This type is also indicated 
by magic number 0413 in the operating system 
header. It is distinguished by having virtual text 
and data starting addresses that are equal to the 
file offsets of the text and data sections, modulo 
4096. The —F option is on by default. 


Output a message giving information about the 
version of ld being used. 


—VS num 


—Ww 


FILES 


Use num as a decimal version number 
identifying the a.out file that is produced. The 
version stamp is stored in the optional header. 


Change the symbol name look-up algorithm as 
follows: if two names do not initially match, 
then if one of them is exactly eight characters, 
then a match is attempted only on the first eight 
characters. The purpose of this is to allow 
compatibility between object modules that have 
been created with and the old C compiler and 
with the new C compiler, which allows variable 
names more than eight characters long. A 
warning message is issued in such cases. 


If —G is used, do not print warnings about 
symbols that partially matched. 


/\ib/liba.a libraries 
/usr/lib/libz/fR.a libraries 


a.out 


output file 


/lib /ifile.0407 default —N directive file 
/lib/ifile.0410 default —n directive file 
/lib /ifile.0413 default —z directive file 
/lib /ifile.0413-F default —F directive file 


SEE ALSO 


as(1),cc(1), exit(2), end(3C), a.out(4),ar(4). 


CAVEATS 


Through its options and input directives, the common 
link editor gives users great flexibility; however, those 
who use the input directives must assume some added 
responsibilities. Input directives and options should 
insure the following properties for programs: 
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C defines a zero pointer as null. A pointer to 
which zero has been assigned must not point to any 
object. To satisfy this, users must not place any 
object at virtual address zero in the data space. 


LDDRV(1M) 


/ete/lddrv/lddrv — manage loadable drivers 


SYNOPSIS 
Iddrv [| —m master] [ -abdqsuv | [ devname | 
subdevs || 
ddrv —a [v | | —m master | [| —o dfile ] devname 
{ subdevs | 
Iddrv -d iv —m master | devname 
Iddrv —b |v —m master | devname 
Iddrv —u jv —m master | devname F 
Iddrv —q {v —m master | devname 
Iddrv —s [v —m master 

DESCRIPTION 


Lddrv allocates/deallocates space for a specified driver, 
loads/unloads a specified driver, and returns the status 
of specified drivers) 


The v argument prints verbose information on the 
screen. The —m option allows overriding the default | 
master file (/etc/master). Use —o dfile to specify the | 
name of the file that contains the driver’s executable | 
code; if omitted, executable code is placed in the file 

devname. The deuname argument is the name of the 

driver. 


Devname must correspond to the first field in the master 
file. In addition, the relocatable driver code must be in a 
file named devname.o. More than one major device may 
be plugged with a single invocation of Udrv by specifying 
up to three subdevices. 


The options are: 


—a Allocate space for and load the driver. 

-d Unload the driver and deallocate its space. 

—-b Load (bind) the driver. 

—u Unload the driver. 

-q Return the status of a particular loadable driver. 

-8 Return the status of all loadable drivers. 
EXAMPLES 


A status report for all drivers could look like: 


DEVNAME ID BLK CHAR SIZE ADDR FLAGS 
lipe OF | - -  0x5000 Ox3dd000 ALLOC BOUND 
plp 1 - 6 0x1000 0x3e2000 ALLOC BOUND 
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FILES 
/etc/master default master file 
/etc/drvtbl loadable driver table 
/etc/lddrv contains /ddrv and loadable drivers 


SEE ALSO ; 
syslocal(2), master(4), drivers(7). 


NAME 


LDEEPROM ( 1M ) 


Ideeprom — load EEPROM 


SYNOPSIS 


ldeeprom | —s <system file> ] 


DESCRIPTION 


FILES 


When called by /etc/drvload, Ideeprom loads the 
electrically erasable, programmable read-only memory on 
the VME interface card. 

Ldeeprom reads the FILENAMES, !VMESLOTS, and 
!'VMECODE sections of the /etce/system file and 
generates binary data that can be written to the 
EEPROM. Ldeeprom reads two variables in the 
!1FILENAMES section: 


PROM_IFILE the file that will provide /d(1) with 
relocation information for the 
!VMECODE section. 


EEPROM_FILE the file to which to output the EEPROM 
binary data. If the file name is 
/dev/vme/eeprom, the contents of 
this special file is written directly to the 
EEPROM; if any other file name is 
given, the contents is written to that 
file instead. 


Ldeeprom reads the !VMESLOTS section for 
descriptions of the VME boards. 

Ldeeprom reads the 'WMECODE section for the names 
of object code files. These object files are to be loaded 
into the EEPROM to provide the boot code for a device 
where an initialization function name is specified. 

The —s option can be used to specify a file to be used 
instead of the /etc/system file. 


/dev/vme/eeprom default EEPROM file 
/etc/drvload 
/etc/system 


SEE ALSO 


5/86 


your): vme(7). 
MightyFrame Datta? 8 Reference Manual. 
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NAME 

lex — generate programs for simple lexical tasks 
SYNOPSIS 

lex { —retvn | { file | ... 
DESCRIPTION 


Lex generates programs to be used in simple lexical 
analysis of text. 


The input files (standard input default) contain strings 
and expressions to be searched for, and C text to be 
executed when strings are found. 


A file lex.yy.c is generated which, when loaded with the 
library, copies the input to the output except when a 
string specified in the file is found; then the 
corresponding program text is executed. The actual 
string matched is left in yytezt, an external character 
array. Matching is done in order of the strings in the 
file. The strings may contain square brackets to indicate 
character classes, as in {abx—z] to indicate a, b, x, y, 
and z; and the operators *, +, and ? mean respectively 
any non-negative number of, any positive number of, 
and either zero or one occurrences of, the previous 
character or character class. The character . is the class 
of all ASCII characters except new-line. Parentheses for 
grouping and vertical bar for alternation are also 
supported. The notation r{d,e} in a rule indicates 
between d and e instances of regular expression r. It 
has higher precedence than |, but lower than *, ?, +, 
and concatenation. The character ~ at the beginning of 
an expression permits a _ successful match only 
immediately after a new-line, and the character $ at the 
end of an expression requires a trailing new-line. The 
character / in an expression indicates trailing context; 
only the part of the expression up to the slash is 
returned in yytezt, but the remainder of the expression 
must follow in the input stream. An operator character 
may be used as an ordinary symbol if it is within ” 
symbols or preceded by \. Thus [a-zA—Z]+ matches a 
string of letters. 


Three subroutines defined as macros are expected: 
input() to read a character; unput(c) to replace a 
character read; and output(c) to place an output 
character. They are defined in terms of the standard 
streams, but you can override them. The program 
generated is named yylex(), and the library contains a 
main() which calls it. The action REJECT on the right 
side of the rule causes this match to be rejected and the 
next suitable match executed; the function yymore() 


pe 
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accumulates additional characters into the same yytezt; 
and the function yyless(p) pushes back the portion of 
the string matched beginning at p, which should be 
between yytezt and yytert+yyleng. The macros input 
and output use files yyin and yyout to read from and 
write to, defaulted to stdin and stdout, respectively. 


Any line beginning with a blank is assumed to contain 
only C text and is copied; if it precedes %% it is copied 
into the external definition area of the lex.yy.e file. All 
rules should follow a %%, as in YACC. Lines preceding 
%% which begin with a non-blank character define the 
string on the left to be the remainder of the line; it can 
be called out later by surrounding it with {}. Note that 
curly brackets do not imply parentheses; only string 
substitution is done. 


EXAMPLE 
(o-9} 


5% 
printf("IF statement\n”); 
faced printf(”"tag, value Fees vytext) 
thy. +  printf(”octal number an syytext); 
printf(” decimal cae s\n" yytext); 
a printf(”unary op\n 
printf{(”binary op\n x 
m [x { loop: 
while (input() != '*'); 
switch (input()) 


case '/': break; 
case '*!; unput(*’); 
default: go to loop; 


} 


The external names generated by /ex all begin with the 
prefix yy or YY. 


The flags must appear before any files. The flag —r 
indicates RATFOR actions, —c indicates C actions and is 
the default, —t causes the lex.yy.c program to be 
written instead to standard output, —v provides a one- 
line summary of statistics of the machine generated, —n 
will not print out the — summary. Multiple files are 
treated as a single file. If no files are specified, standard 
input is used. 


Certain table sizes for the resulting finite state machine 
can be set in the definitions section: 
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%p n number of positions is n (default 2000) 
%nn number of states is n (500) 

%tn number of parse tree nodes is n (1000) 
%an number of transitions is n (3000) 


The use of one or more of the above automatically 
implies the —v option, unless the —n option is used. 
SEE ALSO 
yace(1). 
CTIX Programmer’s Guide, Section 17. 


BUGS 
The —r option is not yet fully operational. 
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NAME 

line — read one line 
SYNOPSIS 

line 
DESCRIPTION 


Line copies one line (up to a new-line) from the standard 
input and writes it on the standard output. It returns an 
exit code of 1 on EOF and always prints at least a new- 
line. It is often used within shell files to read from the 
user’s terminal. 


SEE ALSO 
sh(1), read(2). 
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NAME 
link, unlink — exercise link and unlink system calls 


SYNOPSIS 
/ete/link filel file? 
/ete/unlink file 


DESCRIPTION 
Link and unlink perform their respective system calls on 
their arguments, abandoning all error checking. These 
commands may only be executed by the super-user, whc 
(it is hoped) knows what he or she is doing. 


SEE ALSO 
rm(1), link(2), unlink(2). 
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NAME 

lint — a C program checker 
SYNOPSIS 

lint [ option | ... file ... 
DESCRIPTION 


Lint attempts to detect features of the C program file 
that are likely to be bugs, non-portable, or wasteful. It 
also checks type usage more strictly than the compilers. 
Among the things that are currently detected are 
unreachable statements, loops not entered at the top, 
automatic variables declared and not used, and logical 
expressions whose value is constant. Moreover, the usage 
of functions is checked to find functions that return 
values in some places and not in others, functions called 
with varying numbers or types of arguments, and 
functions whose values are not used or whose values are 
used but none returned. 


Arguments whose names end with .c are taken to be C 
source files. Arguments whose names end with .In are 
taken to be the result of an earlier invocation of lint with 
either the —e or the—o option used. The .In files are 
analogous to .o (object) files that are produced by the 
ec(1) command when given a.c file as input. Files with 
other suffixes are warned about and ignored. 


Lint will take all the .c, .In, and Ilib-lz.In (specified by 
~1z) files and process them in their command line order. 
By default, lint appends the standard C lint library 
(llib-le.In) to the end of the list of files. However, if the 
—p option is used, the portable C lint library (llib- 
port.In) is appended instead. When the —e option is 
not used, the second pass of lint checks this list of files 
for mutual copatibility. When the —e option is used, the 
«In and the the Ilib-Iz.In files are ignored. 


Any number of lint options may be used, in any order, 
intermixed with file-name arguments. The following 
options are used to suppress certain kinds of complaints: 


—8 Suppress complaints about assignments of long 
values to variables that are not long. 


-b Suppress complaints about break statements 
that cannot be reached. (Programs produced by 
ler or yace will often result in many such 
complaints.) 


-h Do not apply heuristic tests that attempt to 
intuit bugs, improve style, and reduce waste. 


—u 


-v 


—-x 
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Suppress complaints about functions and 
external variables used and not defined, or 
defined and not used. (This option is suitable 
for running lint on a subset of files of a larger 
program.) 


Suppress complaints about unused arguments in 
functions. 


Do not report variables referred to by external 
declarations but never used. 


The following arguments alter lint’s behavior: 


—Iz 


—n 


—-p 


—c 


—o lib 


Include additional lint library Hib-Iz.In. For 
example, you can include a lint version of the 
math library lib-lm.In by inserting —lm on the 
command line. This argument does not suppress 
the default use of llib-le.In. These line libraries 
must be in the assumed directory. This option 
can be used to reference local lint libraries and is 
useful in the development of multi-file projects. 


Do not check compatibility against either the 
standard or the portable lint library. 


Attempt to check portability to other dialects 
(IBM and GCOS) of C. Along with stricter 
checking, this option causes all non-external 
names to be truncated to eight characters and 
all external names to be truncated to six 
characters and one case. 


Cause lint to produce a .In file for every .c file 
on the command line. These .In files are the 
product of lint’s first pass only, and are not 
checked for inter-function compatibility. 


Cause lint to create a lint library with the name 
llib-l/sb.In. The —c option nullifies any use of 
the —o option. The lint library produced is the 
input that is given to lint’s second pass. The —o 
option simply causes this file to be saved in the 
named lint library. To produce a Ilib-Il:).In 
without extraneous messages, use of the —x 
option is suggested. The —v option is useful if 
the source file(s) for the lint library are just 
external interfaces (for example, the way the file 
llib-le is written). These option settings are also 
available through the use of “lint commants”’ 
(see below). 


The —D, —U, and —I options of cpp(1) and the ~g and 
—O options of ce(1) are also recognized as separate 
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arguments. The —g and —O options are ignored, but, by 
recognizing these options, lint’s behavior is closer to that 
of the ec(1) command. Other options are warned about 
and ignored. The pre-processor symbol “‘lint” is defined 
to allow certain questionable code to be altered or 
removed for lint. Therefore, the symbol “‘lint”’ should be 
thought of as a reserved word for all code that is planned 
to be checked by lint. 


Certain conventional comments in the C source will 
change the behavior of lint: 


/*NOTREACHED*/ 
at appropriate points stops comments 
about unreachable code. 


/*VARARGSn*/ 
suppresses the usual checking for 
variable numbers of arguments in the 
following function declaration. The data 
types of the first mn arguments are 
checked; a missing n is taken to be 0. 


/ *ARGSUSED*/ 
turns on the —v option for the next 
function. 


if *LINTLIBRARY* / 
at the beginning of a file shuts off 
complaints about unused functions in 
this file. 


Lint produces its first output on a per-source-file basis. 
Complaints regarding included files are collected and 
printed after all source files have been processed. 
Finally, if the -e option is not used, information 
gathered from all input files is collected and checked for 
consistency. At this point, if it is not clear whether a 
complaint stems from a given source file or from one of 
its included files, the source file name will be printed 
followed by a question mark. 


The behavior of the —e and the —o options allows for 
incremental use of lint on a set of C source files. 
Generally, one invokes lint once for each source file with 
the —e option. Each of these invocations produces a .In 
file which corresponds to the .c file, and prints all 
messages that are about just that source file. After all 
the source files have been separately run through /tnt, it 
is invoked once more (without the —c option), listing all 
the .In files with the needed —Iz options. This will print 
all the inter-file inconsistencies. This scheme works well 
with make(1); it allows make to be used to lint only the 
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source files that have been modified since the last time 
the set of source files were ltnted. 


FILES 
/usr/lib 


/usr/lib/lint[12] 
/usr/lib/Ilib-le.In 


/usr/lib/llib-port.In 
/usr/lib/lib-lm.In 


/usr/tmp/*lint* 
SEE ALSO 


the directory where the lint libraries 

specified by the —lz option must 

exist 

first and second passes 

declarations for C Library functions 
ina format; source is in 

/ ae ib / llib- le) 

declarations for portable functions 

(bina: format; source is in 

/ usr /lib / llib-port) 

declarations for Math Library 

functions (binary format; source is 

in /usr/lib/Ilib-lm) 

temporaries 


ec(1), cpp(1), make(1). 


exit(2) longjymp(3C), and other functions that do not 
return are not understood; this causes various lies. 


BUGS 


oo 


NAME 


LOGIN(1) 


login — sign on 


SYNOPSIS 


login [ name [ env-var ... | | 


DESCRIPTION 


The login command is used at the beginning of each 
terminal session and allows you to identify yourself to 
the system. It may be invoked as a command or by the 
system when a connection is first established. Also, it is 
invoked by the system when a previous user has 
terminated the initial shell by typing a enirl-d to 
indicate an ‘‘end-of-file.” (See How to Get Started at the 
beginning of this volume for instructions on how to dial 
up initially.) 
If login is invoked as a command it must replace the 
initial command interpreter. This is accomplished by 
typing: 

exec login 
from the initial shell. 


Login asks for your user name (if not supplied as an 
argument), and, if appropriate, your password. Echoing 
is turned off (where possible) during the typing of your 
password, so it will not appear on the written record of 
the session. 


At some installations, an option may be invoked that 
will require you to enter a second ‘‘dialup’’ password. 
This will occur only for dial-up connections, and will be 
prompted by the message “dialup password:”. Both 
passwords are required for a successful login. 


If you do not complete the login successfully within a 
certain period of time (e.g., one minute), you are likely 
to be silently disconnected. 


After a successful login, accounting files are updated, the 
procedure perc) peels is performed (or /ete/cprofile 
for csh), the message-of-the-day, if any, is printed, the 
user-ID, the group-ID, the working directory, and the 
command interpreter (usually sh(1)) is initialized, and 
the file .profile (or .cshre and .login for csh) in the 
working directory is executed, if it exists. These 
specifications are found in the /etc/passwd file entry 
for the user. The name of the command interpreter is — 
followed by the last component of the interpreter’s 
pathname (i.e., —sh). If this field in the password file is 
empty, then the default command interpreter, /bin/sh 
is used. If this field is ‘“*”, then a chroot(2) is done to 
the directory named in the directory field of the entry. 


ae 
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At that point login is re-executed at the new level which 
must have its own root structure, including /ete/login 
and /etc/passwd. 


The basic environment (see environ(5)) is initialized to: 


HOME=your-login-directory 
PATH=:/bin:/usr/bin 
SHELL=1(ast-field-of-passwd-eniry 
MAIL=/usr/mail/your-login-name 
TZ=timezone-spectfication 


The environment may be expanded or modified by 
supplying additional arguments to login, either at 
execution time or when fogtn requests your login name. 
The arguments may take either the form zzz or 
zzz=yyy. Arguments without an equal sign are placed in 
the environment as 
Ln=xxx 

where n is a number starting at 0 and is incremented 
each time a new variable name is required. Variables 
containing an == are placed into the environment 
without modification. If they already appear in the 
environment, then they replace the older value. There 
are two exceptions. The variables PATH and SHELL 
cannot be changed. This prevents people, logging into 
restricted shell environments, from spawning secondary 
shells which are not restricted. Both login and getty 
understand simple single-character quoting conventions. 
Typing a backslash in front of a character quotes it and 
allows the inclusion of such things as spaces and tabs, 


FILES 
/etc/utmp accounting 
/ete/wtmp accounting 
/usr/mail/your-name mailbox for user your-name 
/etc/motd message-of-the-day 
/etc/passwd password file 
/etc/profile system profile 
.profile user’s login profile 

SEE ALSO 


mail(1), newgrp(1), sh(1), su(1), passwd(4), profile(4), 
environ(5). 


DIAGNOSTICS 


Login incorrect if the user name or the password cannot 
be matched. 

No shell, cannot open password file, or no directory: 
consult your system administrator. 

No utmp entry. You must ezec "login" from the lowest 
level "sh". if you attempted to execute login as a 
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command without using the shell’s exec internal 
command or from other than the initial shell. 
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NAME 
logname — get login name 

SYNOPSIS 
logname 

DESCRIPTION 
Logname returns the contents of the environment 
variable $LOGNAME, which is set when a user logs into 
the system. 

FILES 
/etc/profile 


SEE ALSO 
env(1), login(1), logname(3X), environ(5). 


NAME 


LORDER(1) 


lorder — find ordering relation for an object library 


SYNOPSIS 


lorder file ... 


DESCRIPTION 


FILES 


The input is one or more object or library archive files 
(see ar(i)). The standard output is a list of pairs of 
object WY names, meaning that the first file of the pair 
refers to external identifiers defined in the second. The 
output may be processed by tsort(1) to find an ordering 
of a library suitable for one-pass access by Id(1). Note 
that the link editor /d(1) is capable of multiple passes 
over an archive in the portable archive format (see ar(4)) 
and does not require that lorder(1) be used when 
building an archive. The usage of the lorder(i) 
command may, however, allow for a slightly more 
efficient access of the archive during the link edit 
process. 


The following example builds a new library from existing 
-o files. 


ar cr library * lorder *.o | tsort* 


*symref, *symdef temporary files 


SEE ALSO 


BUGS 


ar(L), Ild(1), tsort(1), ar(4). 


Object files whose names do not end with .o, even when 
contained in library archives, are overlooked. Their 
global symbols and references are attributed to some 
other file. 
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NAME 
Ip, cancel — send/cancel requests to an LP line printer 


SYNOPSIS 
Ip Sa ~ddest} (—m] [—nnumber] [-ooption] [—s] 


(—t title] (—w] files 
cancel {ids | { printers | 
DESCRIPTION 


Lp arranges for the named files and associated 
information (collectively called a request) to be printed 
by a line printer. If no file names are mentioned, the 
standard input is assumed. The file name — stands for 
the standard input and may be supplied on the 
command line in conjunction with named files. The 
order in which files appear is the same order in which 
they will be printed. 


Lp associates a unique td with each request and prints it 
on the standard output. This td can be used later to 
cancel (see cancel) or find the status (see [pstat(1)) of the 
request. 


The following options to /p may appear in any order and 
may be intermixed with file names: 


~¢c Make copies of the files to be printed 
immediately when Ip is invoked. Normally, 
files will not be copied, but will be linked 
whenever possible. If the —e option is not 
given, then the user should be careful not to 
remove any of the files before the request 
has been printed in its entirety. It should 
also be noted that in the absence of the —e 
option, any changes made to the named 
files after the request is made but before it 
is printed will be reflected in the printed 
output. 


—ddest Choose dest as the printer or class of 
printers that is to do the printing. If dest is 
a printer, then the request will be printed 
only on that specific printer. If dest is a 
class of printers, then the request will be 
printed on the first available printer that is 
a member of the class. Under certain 
conditions (printer unavailability, file space 
limitation, etc.), requests for specific 
destinations may not be accepted (see 
accept(1M) and Ipstat(1)). By default, dest 
is taken from the environment variable 
LPDEST (if it is set). Otherwise, a default 
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destination (if one exists) for the computer 
system is used. Destination names vary 
between systems (see (pstat(1)). 


—m Send mail (see mail(1)) after the files have 
been printed. By default, no mail is sent 
upon normal completion of the print 
request. 

~nnumber Print number copies (default of 1) of the 
output. 


—ooption Specify printer-dependent or class-dependent 
options. Several such options may be 
collected by specifying the ~o keyletter 
more than once. For more information 
about what is valid for options, see Meadels 
in lpadmin(1M). 


-s Suppress messages from I[p(1) such as 
"request id is ...”. 


—ttitle Print title on the banner page of the output. 


—Ww Write a message on the user’s terminal after 
the files have been printed. If the user is 
not logged in, then mail will be sent instead. 


Cancel cancels line printer requests that were made by 
the /p(1) command. The command line arguments may 
be either request tds (as returned by /, () or printer 
names (for a complete list, use Ipstat(1)). pecifying a 
request id cancels the associated request even if it is 
currently printing. Specifying a printer cancels the 
request which is currently printing on that printer. In 
either case, the cancellation of a request that is currently 
printing frees the printer to print its next available 
request. 


/usr/spool/\p/* 


SEE ALSO 


accept(1M), enable(1), Ipstat(1), Ipadmin(1M), 
Ipsched(1M), mail(1). 

MightyFrame Administrator's Reference Manual. 
MiniFrame Administrator's Manual. 
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NAME 
Ipadmin — configure the LP spooling system 
SYNOPSIS 
/usr/lib/lpadmin —p printer { options | 
/usr/lib/Ipadmin —x dest 
/usr/lib/Ipadmin —d(dest} 
DESCRIPTION 


Lpadmin configures LP spooling systems to describe 
printers, classes and devices. It is used to add and 
remove destinations, change membership in classes, 
change devices for printers, change printer interface 
programs and to change the system default destination. 
Lpadmin may not be used when the LP scheduler, 
Ipsched(1M), is running, except where noted below. 


Exactly one of the —p, —d or —x options must be 
present for every legal invocation of lpadmin. 


—d{dest| makes dest, an existing destination, the 
new system default destination. If dest is 
not supplied, then there is no system 
default destination. This option may be 
used when [psched(1M) is running. No 
other options are allowed with —d. 


~—xdest removes destination dest from the LP 
system. If dest is a printer and is the only 
member of a class, then the class will be 
deleted, too. No other options are allowed 
with —x. 

—pprinter names a printer to which all of the options 
below refer. If printer does not exist then 
it will be created. 

The following options are only useful with —p and may 

appear in any order. For ease of discussion, the printer 

will be referred to as P below. 


—cclass inserts printer P into the specified class. 
Class will be created if it does not already 
exist. 


—eprinter copies an existing printer’s interface 
program to be the new interface program 
for P. 


—h indicates that the device associated with P 
is hardwired. This option is assumed when 
creating a new printer unless the —1 option 
is supplied. 


LPADMIN( 1M) 


—iinterface establishes a new interface program for P. 
Interface is the pathname of the new 
program. 


-! indicates that the device associated with P 
is a login terminal. The LP scheduler, 
tpsoned( TM) disables all login terminals 
automatically each time it is started. 
Before re-enabling P, its current device 
should be established using lpadmin. 


—mmodel selects a model interface program for P. 
Model is one of the model interface names 
supplied with the LP software (see Models 
below). 

—rclass removes printer P from the specified class. 
If P is the last member of the class, then 
the class will be removed. 


—vdevice associates a new device with printer P. 
Device is the pathname of a file that is 
writable by the LP administrator, [p. Note 
that there is nothing to stop an 
administrator from associating the same 
device with more than one printer. If only 
the —p and —v options are supplied, then 
lpadmin may be used while the scheduler is 
running. 


Restrictions. 

When creating a new printer, the —v option and one of 
the —e, —i or —m options must be supplied. Only one of 
the —e, —i or —m options may be supplied. The —h and 
—! keyletters are mutually exclusive. Printer and class 
names may be no longer than 14 characters and must 
consist entirely of the characters A-Z, a-z, 0-9 and _ 
(underscore). 


Models. 

Model printer interface programs are supplied with the 
LP software. They are shell procedures which interface 
between lpsched(1M), and devices. All models reside in 
the directory /usr spool/Ip /model and may be used 
as is with lpadmin -m. Models should have 644 
permission if owned by Ip and bin, or 664 permission if 
owned by bin and bin. Alternatively, LP administrators 
may modify copies of models and then use lpadmin —i to 
associate them with printers. The following list describes 
the models and lists the options which they may be 
given on the [p command line using the —o keyletter: 


dumb 


1640 


hp 


prx 


EXAMPLES 
1. 
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interface for a line printer without special 
functions and _ protocol. Form feeds are 
assumed. This is a good model to copy and 
modify for printers which do not have models. 


DIABLO 1640 terminal running at 1200 baud, 

using XON/XOFF protocol. Options: 

-12  12-pitch (10-pitch is the defauit) 

-f do not use the 450(1) filter. The output 
has been pre-processed by either 450(1) 
or the nroff(1) 450 driving table. 


Hewlett-Packard 2631A line printer at 2400 
baud. Options: 


—e compressed print 
_e expanded print 


Printronix P300 or P600 printer’ using 
XON/XOFF protocol at 1200 baud. 


Assuming there is an existing Hewlett-Packard 


2631A line printer named Ap2, it will use the hp 
model interface after the command: 


/usr/lib/Ipadmin -php2 -mhp 


2. To obtain compressed print on hAp2, use the 
command: 


lp -—dhp2 -o-c files 


3. A DIABLO 1640 printer called st! can be added to 
the LP configuration with the command: 


/usr/lib/Ipadmin -pstl ~v/dev/tty20 —m1640 


4. An nroff(1) document may be printed on /p in any 
of the following ways: 


nroff ~T450 eo Ip -dst1 -of 
nroff -T450—-12 fi eH Ip -dstl —-of 
nroff —T37 files | col | lp —dsti 


5. The following command prints the password file on 
st in 12-pitch: 


Ip —dstl -012 /etc/passwd 


NOTE: the —12 option to the 1840 mode) should 
never be used in conjunction with nroff(1). 


FILES 


/usr/spool/lp/* 


— 
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SEE ALSO 
accept(1M), enable(1), Ip(1), Ipsched(1M), Ipstat(1), 
nroff(1). 
MightyFrame Administrator’s Reference Manual. 
MintFrame Administrator’s Manual. 
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NAME 

lpr — line printer spooler 
SYNOPSIS 

Ipr [ option ... | { name ... ] 
DESCRIPTION 


Lpr causes the named files to be queued for printing on 
a line printer. If no names appear, the standard input is 
assumed; thus lpr may be used as a filter. 


Lpr is a simple alternative to the /p(1) system. The 
same system should not use both. 


Lpr uses a CTIX demon to manage spooling. 


The following options may be given (each as a separate 
argument and in any order) before any file name 
arguments: 


—¢ Makes a copy of the file to be sent before 
returning to the user. 


-r Removes the file after sending it. 
FILES 
/etc/passwd user’s identification and 
accounting data 
/usr/lib/Ipd line printer daemon 
/usr/spool/Ipd/* spool area 
/ete/re initialization for lp or lpr spooling 
system 
SEE ALSO 


MightyFrame Administrator’s Reference Manual. 
MintFrame Administrator’s Manual. 


NAME 


LPSCHED (1M) 


Ipsched, Ipshut, Ipmove — start/stop the LP request 
scheduler and move requests 


SYNOPSIS 


/usr/lib/Ipsched 
/usr/lib/Ipshut 
/usr/lib/Ipmove requests dest 
/usr/lib/Ipmove destl dest2 


DESCRIPTION 


Lpsched schedules requests taken by /p(1) for printing on 
line printers. 


Lpshut shuts down the line printer scheduler. All 
printers that are printing at the time /pshut is invoked 
will stop printing. Requests that were printing at the 
time a printer was shut down will be reprinted in their 
entirety after Ipsched is started again. Al] LP commands 
perform their functions even when Ipsched is not 
running. 


Lpmove moves requests that were queued by /p(1) 
between LP destinations. This command may be used 
only when (psched is not running. 


The first form of the command moves the named 
requests to the LP destination, dest. Requests are 
request ids as returned by /p(1). The second form moves 
all requests for destination dest! to destination dest2. 
As a side effect, /p(1) will reject requests for dest. 


Note that lpmove never checks the acceptance status 
(see accept(1M)) for the new destination when moving 
requests. 


FILES 

/usr/spool /Ip/* 

/ete/re invocation of lpsched 
SEE ALSO 


accept(1M), enable(1), Ip(1), lpadmin(1M), Ipstat(1). 
MightyFrame Administrator’s Reference Manual. 
MintFrame Administrator’s Manual. 
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NAME 
Ipset — set parallel line printer options 
SYNOPSIS 
Ipset { control options | [mode options ] 
DESCRIPTION 
Lpset sets the translation options for the parallel printer 
interface. It is normally run in /ete/re. The following 
control options may be used; the interpretation of these 
options by the interface is described under (p(7). 
—in Set the indent to n. 
—cn Set the number of columns to n. 
—ln Set the number of lines per page to n. 
—pprinter_id Print on the specified printer; printer_id 
may be O or 1. If printer_id is not 
specified, /dev/plp is used. 
The following mode option choices may also be selected. 
bs | nobs Backspace/No backspace 
raw|canon Raw output mode/Canonical mode 
cap |allcase Translate lowercase to capitals/Both 
upper- and lowercase 
cr | nocr Carriage return/No carriage return 
ff | noff Formfeed/No formfeed 
nl | nonl New-line/No new-line 
With no options, /pset reports the current values of 
device dev/plp. Initially, the values are: an indent of 4, 
132 columns, 66 lines per page. If —e is set to 0, the 
contro] values and modes will be set to their default 
values. 
EXAMPLE 
lpset —i4 —c80 -10 —pl noff 
This command specifies an indent of 4, 80 columns 
across the page, and no automatic formfeeds for line 
printer /dev/plp1. 
FILES 
/dev/Ip 
SEE ALSO 
Ip(7). 
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NAME 

Ipstat — print LP status information 
SYNOPSIS 

Ipstat [ options | 
DESCRIPTION 


Lpstat prints information about the current status of the 
LP line printer system. 


If no options are given, then lpstat prints the status of 
all requests made to [p(1) by the user. Any arguments 
that are not options are assumed to be request ids (as 
returned by Ip). Lpstat prints the status of such 
requests. Options may appear in any order and may be 
repeated and intermixed with other arguments. Some of 
the keyletters below may be followed by an optional list 
that can be in one of two forms: a list of items separated 
from one another by a comma, or a list of items enclosed 
in double quotes and separated from one another by a 
comma and/or one or more spaces. For example: 


—u”userl, user2, user3” 


The omission of a list following such keyletters causes all 
information relevant to the keyletter to be printed, for 
example: 


Ipstat —o 
prints the status of all output requests. 


—a{ list] Print acceptance status (with respect to Ip) of 
destinations for requests. List is a list of 
intermixed printer names and class names. 


—ce| list] Print class names and their members. List is 
a list of class names. 


-d Print the system default destination for Ip. 


—o[ list] Print the status of output requests. List is a 
list of intermixed printer names, class names, 
and request ds. 


—p[ list] Print the status of printers. List is a list of 
printer names. 


-r Print the status of the LP request scheduler 


-8 Print a status summary, including the status 
of the line printer scheduler, the system 
default destination, a list of class names and 
their members, and a list of printers and their 
associated devices. 


—t Print all status information. 
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—u[ list] Print status of output requests for users. List 
is a list of login names. 

—v[ list] Print the names of printers and _ the 
pathnames of the devices associated with 
them. List is a list of printer names. 

FILES 

/usr/spool/lp/* 
SEE ALSO 

enable(1), Ip(1). 


NAME 


LS(1) 


ls — list contents of directory 


SYNOPSIS 


Is | -RadCxmlnogrtucpF bqisf ] [names] 


DESCRIPTION 


directory; for each file argument, /s repeats its name and 
any other information requested. The output is sorted 
alphabetically by default. When no argument is given, 
the current directory is listed. When several arguments 
are given, the arguments are first sorted appropriately, 
but file arguments appear before directories and their 
contents. 


For each directory argument, /s lists the contents of the 


There are four listing formats: 


° Multicolumn format. This is the default 
when the standard output is a terminal. 
By default this format sorts names down 
the page; the —x option controls this. 
Choice of multicolumn format is 
controlled manually by the —C option. 


° Simple (one entry per line) format. This 
is the default when the standard output is 
not a terminal. Each line consists of a 
file name together with whatever 
additional information is requested by 


options. 
° Long format. See the the —1 option. 
e Stream format. See the —m option. 


The number of columns used in multicolumn and stream 
format is taken from an _ environment variable, 
COLUMNS. ff this variable is not set, the terminfo 
database is used to determine the number of columns, 
based on the environment variable TERM. If this 
information cannot be obtained, 80 columns are used. 


There are an unbelievable number of options: 
-R Recursively list subdirectories encountered. 


—a List all entries; usually entries whose names 
begin with a period (.) are not listed. 


—d If an argument is a directory, list only its name 
(not its contents); often used with —I to get the 
status of a directory. 


-C Multi-column output with entries sorted down 
the columns. 


—-n 


-oO 


-r 


-t 


—-u 
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Multi-column output with entries sorted across 
rather than down the page. 


Stream output format. 


List in long format, giving mode, number of 
links, owner, group, size in bytes, and time of 
last modification for each file (see below). If the 
file is a special file, the size field will instead 
contain the major and minor device numbers 
rather than a size. 


The same as —l, except that the owner’s UID 
and group’s GID numbers are printed, rather 
than the associated character strings. 


The same as —l, except that the group is not 
printed. 

The same as —l, except that the owner is not 
printed. 

Reverse the order of sort to get reverse 
alphabetic or oldest first as appropriate. 

Sort by time modified (latest first) instead of by 
name. 

Use time of last access instead of last 
modification for sorting (with the —t option) or 
printing (with the —I option). 

Use time of last modification of the i-node (file 
created, mode changed, etc.) for sorting (—t) or 
printing (—1). 

Put a slash (/) after each filename if that file is 
a directory. 

Put a slash (/) after each filename if that file is 
a directory and put an asterisk (*) after each 
filename if that file is executable. 

Force printing of non-graphic characters to be in 
the octal \ddd notation. 

Force printing of non-graphic characters in file 
names as the character (2). 

For each file, print the i-number in the first 
column of the report. 

Give size in 512-byte blocks, including indirect 
blocks, for each entry. 

Force each argument to be interpreted as a 


directory and list the name found in each slot. 
This option turns off —l, —t, —s, and —r, and 
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turns on ~—a; the order is the order in which 
entries appear in the directory. 


The mode printed under the —I option consists of 10 
characters that are interpreted as follows: 


The first character is: 


if the entry is a directory; 

if the entry is a block special file; 

y the entry is a character special 

ile; 

pif the entry is a fifo (a.k.a. “named 
pipe’’) special file; 

— if the entry is an ordinary file. 


arn 


The next 9 characters are interpreted as three 
sets of three bits each. The first set refers to the 
owner’s permissions; the next to permissions of 
others in the user-group of the file; and the last 
to all others. Within each set, the three 
characters indicate permission to read, to write, 
and to execute the file as a program, 
respectively. For a directory, ‘‘execute”’ 
permission is interpreted to mean permission to 
search the directory for a specified file. 


The permissions are indicated as follows: 


if the file is readable; 

if the file is writable; 

if the file is executable; 

if the indicated permission is not 
granted. 


[ean 


The group-execute permission character is given 
as s if the file has set-group-ID mode; likewise, 
the user-execute permission character is given as 
s if the file has set-user-ID mode. The last 
character of the mode (normally x or —) is t if 
the 1000 (octal) bit of the mode is on; see 
chmod(1) for the meaning of this mode. The 
indications of set-ID and 1000 bits of the mode 
are capitalized (S and T respectively) if the 
corresponding execute permission is not set. 


When the sizes of the files in a directory are listed, a 
total count of blocks, including indirect blocks, is 


printed. 

FILES 
/etc/passwd to get user IDs for Is —1 and Is —o. 
/etc/group to get group IDs for Is —1 and Is ~g. 


LS(1) 


/usr/lib/terminfo/* 
to get terminal information. 
SEE ALSO 
chmod(1), find(1). 
BUGS 


Unprintable characters in file names may confuse the 
columnar output options. 


NAME 


M4(1) 


m4 — macro processor 


SYNOPSIS 


m4 [ options | | files | 


DESCRIPTION 


M4 is a macro processor intended as a front end for 
Ratfor, C, and other languages. Each of the argument 
files is ‘processed i in order; if there are no files, or if a file 
name is ~, the standard input is read. The processed 
text is written on the standard output. 


The options and their effects are as follows: 


~e Operate interactively. Interrupts are ignored 
and the output is unbuffered. 

-8 Enable line syne output for the C preprocessor 
(#line ...) 


—Bint Change the size of the push-back and argument 
collection buffers from the default of 4,096. 


—-Hint Change the size of the symbol table hash array 
from the default of 199. The size should be 
prime. 


—Sint Change the size of the call stack from the 
default of 100 slots. Macros take three slots, 
and non-macro arguments take one. 


-Tint Change the size of the token buffer from the 
default of 512 bytes. 


To be effective, these flags must appear before any file 
names and before any ~D or —U flags: 


—Dname[=val] 
Defines name to val or to null in val’s absence. 


—Uname 
undefines name. 


Macro calls have the form: 
name(argl,arg2, ..., argn) 


The ( must immediately follow the name of the macro. 

If the name of a defined macro is not followed by a (, it 

is deemed to be a call of that macro with no arguments. 

Potential macro names consist of alphabetic letters, 

digits, and underscore _, where the first character is not 
a digit. 


Leading unquoted blanks, tabs, and new-lines are ignored 
while collecting arguments. Left and right single quotes 
are used to quote strings. The value of a quoted string is 


Sie 
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the string stripped of the quotes. 


When a macro name is recognized, its arguments are 
collected by searching for a matching right parenthesis. 
If fewer arguments are supplied than are in the macro 
definition, the trailing arguments are taken to be null. 
Macro evaluation proceeds normally during the collection 
of the arguments, and any commas or right parentheses 
which happen to turn up within the value of a nested 
call are as effective as those in the original input text. 
After argument collection, the value of the macro is 
pushed back onto the input stream and rescanned. 


M4 makes available the following built-in macros. They 
may be redefined, but once this is done the original 
meaning is lost. Their values are null unless otherwise 
stated. 


define the second argument is installed as the 
value of the macro whose name is the first 
argument. Each occurrence of $n in the 
replacement text, where n is a digit, is 
replaced by the n-th argument. Argument 
O is the name of the macro; missing 
arguments are replaced by the null string; 
$# is replaced by the number of 
arguments; $* is replaced by a list of all 
the arguments separated by commas; $@ is 
like $*, but each argument is quoted (with 
the current quotes). 


undefine removes the definition of the macro named 
in its argument. 


defn returns the quoted definition of its 
argument(s). It is useful for renaming 
macros, especially built-ins. 


pushdef like define, but saves any previous 
definition. 

popdef removes current definition of its 
argument(s), exposing the previous one, if 
any. 

ifdef if the first argument is defined, the value is 


the second argument, otherwise the third. 
If there is no third argument, the value is 
null. The word uniz is predefined on CTIX 
system versions of m4. 


shift returns all but its first argument. The 
other arguments are quoted and pushed 
back with commas in between. The 
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changequote 


changecom 


divert 


undivert 


divnum 
dnl 


ifelse 


incr 
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quoting nullifies the effect of the extra scan 
that will subsequently be performed. 


change quote symbols to the first and 
second arguments. The symbols may be up 
to five characters long. Changequote 
without arguments restores the original 
values {ie., * 7). 


change left and right comment markers 
from the default # and new-line. With no 
arguments, the comment mechanism is 
effectively disabled. With one argument, 
the left marker becomes the argument and 
the right marker becomes new-line. With 
two arguments, both markers are affected. 
Comment markers may be up to five 
characters long. 


m4 maintains 10 output streams, numbered 
0-9. The final output is the concatenation 
of the streams in numerical order; initially 
stream 0 is the current stream. The dtvert 
macro changes the current output stream 
to its (digit-string) argument. Output 
diverted to a stream other than 0 through 
9 is discarded. 


causes immediate output of text from 
diversions named as arguments, or all 
diversions if no argument. Text may be 
undiverted into another — diversion. 
Undiverting discards the diverted text. 


returns the value of the current output 
stream. 


reads and discards characters up to and 
including the next new-line. 


has three or more arguments. If the first 
argument is the same string as the second, 
then the value is the third argument. If 
not, and if there are more than four 
arguments, the process is repeated with 
arguments 4, 5, 6 and 7. Otherwise, the 
value is either the fourth string, or, if it is 
not present, null. 


returns the value of its argument 
incremented by 1. The value of the 
argument is calculated by interpreting an 
initial digit-string as a decimal number. 


decr 


eval 


len 


index 


substr 


translit 


include 
sinclude 


syscmd 


sysval 
maketemp 
m4exit 


m4wrap 
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returns the value of its argument 
decremented by 1. 


evaluates its argument as an arithmetic 


expression, using 32-bit arithmetic. 
Operators include +, -, *, /, %, * 
(exponentiation), bitwise &, |, *, and 7; 


relationals; parentheses. Octal and hex 
numbers may be specified as in C. The 
second argument specifies the radix for the 
result; the default is 10. The third 
argument may be used to specify the 
minimum number of digits in the result. 


returns the number of characters in its 
argument. 


returns the position in its first argument 
where the second argument begins (zero 
origin), or —1 if the second argument does 
not occur. 


returns a substring of its first argument. 
The second argument is a zero origin 
number selecting the first character; the 
third argument indicates the length of the 
substring. A missing third argument is 
taken to be large enough to extend to the 
end of the first string. 


transliterates the characters in its first 
argument from the set given by the second 
argument to the set given by the third. No 
abbreviations are permitted. 


returns the contents of the file named in 
the argument. 

is identical to include, except that it says 
nothing if the file is inaccessible. 


executes the CTIX system command given 
in the first argument. No value is 
returned. 


is the return code from the last call to 
syscmd. 


fills in a string of XXXXX in its argument 
with the current process ID. 


causes immediate exit from m4. Argument 
1, if given, is the exit code; the default is 0. 


argument 1 will be pushed back at final 
EOF; example: m4wrap(‘*cleanup( ) ”) 


SA 


errprint 


dumpdef 


traceo! 


traceo! 


SEE ALSO 


ao 


n 


ff 


epp(1). 


M4(1) 


prints its argument on the diagnostic 
output file. 


prints current names and definitions, for 
the named items, or for all if no arguments 
are given. 


with no arguments, turns on tracing for all 
macros {including built-ins). Otherwise, 
turns on tracing for named macros. 


turns off trace globally and for any macros 
specified. Macros specifically traced by 
traceon can be untraced only by specific 
calls to traceoff. 


Programmer’s Guide, Section 10. 
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NAME 
mc68k, pdpll, u8b, u3b5, vax — provide truth value 
about your processor type 

SYNOPSIS 
mc68k 


pdpil 
u3b 
u3b5 


vax 


DESCRIPTION 
These commands will return a true value (exit code of 0) 
if you are on a processor that the command name 
indicates. 


The commands that do not apply will return a false 
(non-zero) value. These commands are often used within 
mete(t) makefiles and shell procedures to increase 
portability. 


SEE ALSO 
sh(1), test(1), true(1), false(1), make(1). 
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NAME 

mail, rmail ~ send mail to users or read mail 
SYNOPSIS 

mail { —epgqr | [ -f file | 


mail { —t | persons 


rmail { —t | persons 


DESCRIPTION 


Mail without arguments prints a user’s mail, message- 
by-message, in last-in, first-out order. For each message, F 
the user is prompted with a ?, and a line is read from the 
standard input to determine the disposition of the 


message: 
<new-line> Go on to next message. 
Same as <new-line>. 
d Delete message and go on to 
next message. 
Pp Print message again. 
- Go back to previous message. 
8 | files | Save message in the named 
files (mbox is default). 
w [ files | Save message, without its 


m [persons] Mail the message to the 


q 


header, in the named files 
(mbox is default). 


named persons (yourself is 
default). 

Put undeleted mail back in 
the maslfile and stop. 


EOT (control-d) Same as q. 
x 


leommand 


* 


Put all mail back in the 
matlfile unchanged and stop. 
Escape to the shell to do 
command. 

Print a command summary. 


The optional arguments alter the printing of the mail: 


—~e causes mail not to be printed. An exit value of 0 
is returned if the user has mail; otherwise, an 
exit value of 1 is returned. 

-p causes all mail to be printed without prompting 
for disposition. 


-q causes matl to terminate after interrupts. 
Normally an interrupt only causes’ the 
termination of the message being printed. 

-r a messages to be printed in first-in, first-out 
order. 
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-ffile causes mail to use file (e.g., mbox) instead of 
the default mailfile. 


When persons are named, mail takes the standard input 
up to an end-of-file (or up to a line consisting of just a .) 
and adds it to each person’s mailfile. The message is 
preceded by the sender’s name and a postmark. Lines 
that look like postmarks in the message, (.e., 
“From ...’’) are preceded with a >. The —t option 
causes the message to be preceded by all persons the 
mail is sent to. A _ person is usually a user name 
recognized by fogin(1). If a person being sent mail is 
not recognized, or if mail is interrupted during input, the 
file dead.letter will be saved to allow editing and 
resending. Note that this is regarded as a temporary file 
in that it is recreated every time needed, erasing the 
previous contents of dead.letter. 


To denote a recipient on a remote system, prefix person 
by the system name and exclamation mark (see 
uucp(1C)). Everything after the first exclamation mark 
in persons is interpreted by the remote system. In 
particular, if persons contains additional exclamation 
marks, it can denote a sequence of machines through 
which the message is to be sent on the way to its 
ultimate destination. For example, specifying a!b!cde as 
a recipient’s name causes the message to be sent to user 
biede on system a. System a will interpret that 
destination as a request to send the message to user cde 
on system b. This might be useful, for instance, if the 
sending system can access system a but not system b, 
and system a has access to system b. Mail will not use 
uucp if the remote system is the local system name ({i.e., 
localsystem!user). 


The mailfile may be manipulated in two ways to alter 
the function of mail. The other permissions of the file 
may be read-write, read-only, or neither read nor write 
to allow different levels of privacy. If changed to other 
than the default, the file will be preserved even when 
empty to perpetuate the desired permissions. The file 
may also contain the first line: 


Forward to person 


which will cause all mail sent to the owner of the 
matfile to be forwarded to person. This is especially 
useful to forward all of a person’s mail to one machine in 
a multiple machine environment. In order for 
forwarding to work properly the madfile should have 
“mail” as group ID, and the group permission should be 
read-write. 
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Rmail only permits the sending of mail; uucp(iC) uses 
rmail as a security precaution. 


When a user logs in, the presence of mail, if any, is 
indicated. Also, notification is made if new mail arrives 
while using mad. 


FILES — 
/etc/passwd to identify sender and locate persons 
/usr/mail/user incoming mail for user; i.e., the 

mailfile 
$HOME/mbox saved mail D 
$MAIL variable containing path name of 
mailfile 
/tmp/ma* temporary file 
/usr/mail/*.lock lock for mail directory 
dead. letter unmailable text 
SEE ALSO 


BUGS 


login(1), mailx(1), uucp(1C), write(1). 


Conditions sometimes result in a failure to remove a lock ! 
file. ! 
After an interrupt, the next message may not be printed; l 
printing may be forced by typing a p. 


NAME 
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mailx — interactive message processing system 


SYNOPSIS 


mailx [options] [name...] 


DESCRIPTION 


The command matlz provides a comfortable, flexible 
environment for sending and_ receiving messages 
electronically. When reading mail, masz provides 
commands to facilitate saving, deleting, and responding 
to messages. When sending mail, maslz allows editing, 
reviewing and other modification of the message as it is 
entered. 


Incoming mail is stored in a standard file for each user, 
called the system matlbor for that user. When matiz is 
called to read messages, the matlboz is the default place 
to find them. As messages are read, they are marked to 
be moved to a secondary file for storage, unless specific 
action is taken, so that the messages need not be seen 
again. This secondary file is called the mboz and is 
normally located in the user’s HOME directory (see 
"MBOX" (ENVIRONMENT VARIABLES) for a description 
of this file). Messages remain in this file until forcibly 
removed. 


On the command line, options start with a dash (—) and 
any other arguments are taken to be destinations 
(recipients). If no recipients are specified, masz will 
attempt to read messages from the matlbor. Command 
line options are: 


-d Turn on debugging output. Neither 
particularly interesting nor 
recommended. 

—-e Test for presence of mail. Maizlz prints 


nothing and exits with a successful 
return code if there is mail to read. 

-f /filename/ Read messages from filename instead of 
mailboz. If no filename is specified, the 
mboz is used. 


-F Record the message in a file named 
after the first recipient. Overrides the 
"record” variable, if set (see 
ENVIRONMENT VARIABLES). 

—h number The number of network "hops” made so 


far. This is provided for network 
software to avoid infinite delivery loops. 
-H Print header summary only. 
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-i Ignore interrupts. See also “ignore” 
Py RONEN VARIABLES). 

—n o not initialize from the system 
default Mailz.re file. 

-N Do not print initial header summary. 

—r address Pass address to network delivery 
software. All tilde commands are 
disabled. 

—s subject Set the Subject header field to subject. 

—u user Read user’s matlbor. This is only 
effective if user’s matlbor is not read 
protected. 

-U Convert uucp style addresses to internet 
standards. Overrides the "conv” 


environment variable. 


When reading mail, matlz is in command mode. A 
header summary of the first several messages is 
displayed, followed by a prompt indicating matlz can 
accept regular commands (see COMMANDS below). 
When sending mail, matlz is in input mode. If no subject 
is specified on the command line, a prompt for the 
subject is printed. As the message is typed, maiz will 
read the message and store it in a temporary file. 
Commands may be entered by beginning a line with the 
tilde (~) escape character followed by a single command 
letter and optional arguments. See TILDE ESCAPES for 
a summary of these commands. 


At any time, the behavior of mailz is governed by a set 
of environment vartables. These are flags and valued 
parameters which are set and cleared via the set and 
unset commands. See ENVIRONMENT VARIABLES 
below for a summary of these parameters. 


Recipients listed on the command line may be of three 
types: login names, shell commands, or alias groups. 
Login names may be any network address, including 
mixed network addressing. If the recipient name begins 
with a pipe symbol (|), the rest of the name is taken to 
be a shell command to pipe the message through. This 
provides an automatic interface with any program that 
reads the standard input, such as /p(1) for recording 
outgoing mail on paper. Alias groups are set by the alias 
command is COMMANDS below) and are lists of 
recipients of any type. 


Regular commands are of the form 
[ command ] [ maglist ] [| arguments | 
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If no command is specified in command mode, print is 
assumed. In tnput mode, commands are recognized by 
the escape character, and lines not treated as commands 
are taken as input for the message. 


Each message is assigned a sequential number, and there 
is at any time the notion of a ’current’ message, marked 
by a ’>’ in the header summary. Many commands take 
an optional list of messages (maglist) to operate on, 
which defaults to the current message. A maglist is a list 
of message specifications separated by spaces, which may 
include: 


n Message number n. 

: The current message. 

5 The first undeleted message. 

$ The last message. 

- All messages. 

n—m__s An inclusive range of message numbers. 

user All messages from user. 

/string All messages with string in the subject 
line (case ignored). 


tc All messages of type c, where c¢ is one 
of: 
d deleted messages 
n new messages 
o old messages 
r read messages 
u unread messages 


Note that the context of the command 
determines whether this type of message 
specification makes sense. 


Other arguments are usually arbitrary strings whose 
usage depends on the command involved. File names, 
where expected, are expanded via the normal shell 
conventions (see sh(1)). Special characters are 
recognized by certain commands and are documented 
with the commands below. 


At start-up time, matir reads commands from a system- 
wide file (/usr/lib/mailx/mailx.rc) to initialize certain 
arameters, then from a_ private’ start-up file 
$HOME/.mailre) for personalized variables. Most 
regular commands are legal inside start-up files, the most 
common use being to set up initial display options and 
alias lists. The following commands are not legal in the 
start-up file: !, Copy, edit, followup, Followup, hold, 
mail, preserve, reply, Reply, shell, and visual. Any 
errors in the start-up file cause the remaining lines in the 
file to be ignored. 
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COMMANDS 
The following is a complete list of matlz commands: 


!shell-command 
Escape to the _ shell. See "SHELL” 
(ENVIRONMENT VARIABLES). 


# comment 
Null command (comment). This may be useful 
in .mailre files. 


Print the current message number. 


Prints a summary of commands. 


alias alias name ... 

group altas name ... 
Declare an alias for the given names. The names 
will be substituted when altas is used as a 
recipient. Useful in the .matirc file. 


alternates name ... 
Declares a list of alternate names for your login. 
When responding to a message, these names are 
removed from the list of recipients for the 
response. With no arguments, alternates prints 
the current list of alternate names. See also 
“allnet” (ENVIRONMENT VARIABLES). 


end aneeoe) 

ir [directory] 
Change directory. If directory is not specified, 
$HOME is used. 


filename| 

msglist] filename 
Copy messages to the file without marking the 
messages as saved. Otherwise equivalent to the 
save command. 


copy 
copy 





Copy [meglist| 
Save the specified messages in a file whose name 
is derived from the author of the message to be 
saved, without marking the messages as saved. 
Otherwise equivalent to the Save command. 
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delete [maglist] 
Delete messages from the mazslboz. If 
"autoprint” is set, the next message after the 
last one deleted is printed (see ENVIRONMENT 
VARIABLES). 


discard [header-field ...| 

ignore (header-field <i] 
Suppresses printing of the specified header fields 
when displaying messages on the screen. 
Examples of header fields to ignore are “status” 
and "cc.” The fields are included when the 
message is saved. The Print and Type 
commands override this command. 


dp [msglist 

dt [meglist 
Delete the specified messages from the maslbox 
and print the next message after the last one 
deleted. Roughly equivalent to a delete 
command followed by a print command. 


echo string ... 
Echo the given strings (like echo(1)). 


edit [msglist] 
Edit the given messages. The messages are 
placed in a temporary file and the “EDITOR” 
variable is used to get the name of the editor 
(see ENVIRONMENT VARIABLES). Default 
editor is ed(1). 


exit 

xit 
Exit from maitlz, without changing the mailboz. 
No messages are saved in the mboz (see also 
quit). 


file [filename] 
folder [filename] 
Quit from the current file of messages and read 
in the specified file. Several special characters 
are recognized when used as file names, with the 
following substitutions: 
% the current maitlboz. 
%user 
the ma:lboz for user. 
# the previous file. 
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& the current mboz. 
Default file is the current matlboz. 


folders 
Print the names of the files in the directory set 
by the “folder” variable (see ENVIRONMENT 
VARIABLES). 


followup [message] 
Respond to a message, recording the response in 
a file whose name is derived from the author of 
the message. Overrides the “record” variable, if 
set. See also the Followup, Save, and Copy 
commands and “outfolder’ (ENVIRONMENT 
VARIABLES). 


Followup [meglis¢] 

Respond to the first message in the mazglist, 
sending the message to the author of each 
message in the magitst. The subject line is taken 
from the first message and the response is 
recorded in a file whose name is derived from 
the author of the first message. See also the 
followup, Save, and Copy commands and 
“outfolder” (ENVIRONMENT VARIABLES). 


from (maglist] 
Prints the header summary for the specified 
messages. 


group alias name ... 

alias alias name ... 
Declare an alias for the given names. The names 
will be substituted when altas is used as a 
recipient. Useful in the .maiirc file. 


headers [message| 
tints the page of headers which includes the 
message specified. The “screen” variable sets 
the number of headers per page (see 
ENVIRONMENT VARIABLES). See also the z 
command. 


help 
Prints a summary of commands. 


MAILX(1) 


hold [maglis¢] 
preserve [msglis¢| 


if alr 


olds the specified messages in the matlboz. 


mail-commands 


else 


matl-commands 


endif 


Conditional execution, where s will execute 
following matl-commands, up to an else or endif, 
if the program is in send mode, and r causes the 
matl-commands to be executed only in recetve 
mode. Useful in the .maiire file. 


ignore header-fteld ... 
discard header-field ... 


Suppresses printing of the specified header fields 
when displaying messages on the screen. 
Examples of header fields to ignore are “status” 
and “cc.” All fields are included when the 
message is saved. The Print and Type 
commands override this command. 


list 
Prints all commands available. No explanation 
is given. 

mail name ... 


Mail a message to the specified users. 


mbox [maglts¢] 


Arrange for the given messages to end up in the 
standard mboz save file when maztlz terminates 
normally. See "MBOX” (ENVIRONMENT 
VARIABLES) for a description of this file. See 
also the exit and quit commands. 


next [message] 


Go to next message matching message. A 
msglist may be specified, but in this case the 
first valid message in the list is the only one 
used. This is useful for jumping to the next 
message from a specific user, since the name 
would be taken as a command in the absence of 
a real command. See the discussion of maglists 
above for a description of possible message 
specifications. 
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ipe (maglist] enelt commend| 
Pimestid [shell-command| 
ipe the message through the given  shell- 
command. The message is treated as if it were 
read. If no arguments are given, the current 
message is piped through the command specified 
by the value of the "cmd” variable. If the 
“page” variable is set, a form feed character is 
inserted after each message (see ENVIRONMENT 
VARIABLES). 


preserve (msglis¢| 
hold gta 
Preserve the specified messages in the maslboz. 


Print (maglist 

Type |maglist 
Print the specified messages on the screen, 
including all header _fields. Overrides 
suppression of fields by the ignore command. 





print {meglis¢| 

type [maglis¢] 
Print the specified messages. If “crt” is set, the 
messages longer than the number of lines 
specified by the “crt” variable are paged through 
the command specified by the ”"PAGER” 
variable. The default command is pg(1) (see 
ENVIRONMENT VARIABLES). 


quit 
Exit from matilz, storing messages that were read 
in mbox and unread messages in the mailboz. 
Messages that have been explicitly saved in a file 
are deleted. 


Reply eee 
Respond [meglist 
Send a response to the author of each message in 
the msglist. The subject line is taken from the 
first message. If “record” is set to a filename, 
the response is saved at the end of that file (see 
ENVIRONMENT VARIABLES). 


reply [message] 
respond [message] 
eply to the specified message, including all 
other recipients of the message. If "record” is 
set to a filename, the response is saved at the 
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end of that file (see ENVIRONMENT 
VARIABLES). 


Save [maglis¢| 

Save the specified messages in a file whose name 
is derived from the author of the first message. 
The name of the file is taken to be the author’s 
name with all network addressing stripped off. 
See also the Copy, followup, and Followup 
commands and "outfolder” (ENVIRONMENT 
VARIABLES). 


save (filename| 

save |maglist] filename 
Save the specified messages in the given file. 
The file is created if it does not exist. The 
message is deleted from the matlboz when mailz 
terminates unless "keepsave” is set (see also 
ENVIRONMENT VARIABLES and the exit and 
quit commands). 


set 

set name 

set name=string 

set name=number 
Define a variable called name. The variable 
may be given a null, string, or numeric value. 
Set by itself prints all defined variables and 
their values. See ENVIRONMENT VARIABLES 
for detailed descriptions of the mailz variables. 


shell 


Invoke an interactive shell (see also "SHELL” 
(ENVIRONMENT VARIABLES) 


size [msglist| 
Print the size in characters of the specified 
Messages. 


source filename 
Read commands from the given file and return 
to command mode. 


top [msglis¢] 
Print the top few lines of the specified messages. 
If the "toplines” variable is set, it is taken as the 
number of lines to print (see ENVIRONMENT 
VARIABLES). The default is 5. 
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touch [maglisi| 
Touch the specified messages. If any message in 
meglist is not specifically saved in a file, it will 
be placed in the mboz upon normal termination. 
See exit and quit. 


Type [meglist 
Print |maglist 
Print the specified messages on the screen, 
including all header _fields. Overrides 
suppression of fields by the ignore command. 


type [msglist| 

print (magles¢| 
Print the specified messages. If “crt” is set, the 
messages longer than the number of lines 
specified by the “crt” variable are paged through 
the command specified by the ”"PAGER” 
variable. The default command is pg(1) (see 
ENVIRONMENT VARIABLES). 


undelete [maglis¢| 
Restore the specified deleted messages. Will 
only restore messages deleted in the current mail 
session. If ”“autoprint” is set, the last message of 
those restored is printed (see ENVIRONMENT 
VARIABLES). 


unset name ... 
Causes the specified variables to be erased. If 
the variable was imported from the execution 
environment (i.e., a shell variable) then it cannot 
be erased. 


version 
Prints the current version and release date. 


visual [msglis¢} 
Edit the given messages with a screen editor. 
The messages are placed in a temporary file and 
the “VISUAL” variable is used to get the name 
of the editor (see ENVIRONMENT VARIABLES). 


write [maglist| filename 
Write the given messages on the specified file, 
minus the header and trailing blank line. 
Otherwise equivalent to the save command. 


-10- 


MAILX(1) 


xit 

exit 
Exit from matlz, without changing the mailboz. 
No messages are saved in the mboz (see also 
quit). 

2[+|] 


Scroll the header display forward or backward 
one screen-full. The number of headers 
displayed is set by the "screen” variable (see 
ENVIRONMENT VARIABLES). 


TILDE ESCAPES 


The following commands may be entered only from input 
mode, by beginning a line with the tilde escape character 
. See “escape” (ENVIRONMENT VARIABLES) for 
changing this special character. 
“! shell-command 
Escape to the shell. 


Simulate end of file (terminate message input). 
~: matl-command 
mail-command 


Perform the command-level request. Valid only 
when sending a message while reading mail. 


~? 
Print a summary of tilde escapes. 


“A 
Insert the autograph string "Sign” into the 
message (see ENVIRONMENT VARIABLES). 

“a 
Insert the autograph string “sign” into the 
message (see ENVIRONMENT VARIABLES). 

“b name ... 
Add the names to the blind carbon copy (Bcc) 
list. 

“e name ... 


Add the names to the carbon copy (Cc) list. 


afte 
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Read in the dead.letter file. See ”"DEAD” 
(ENVIRONMENT VARIABLES) for a description 
of this file. 


Invoke the editor on the partial message. See 
also "EDITOR” (ENVIRONMENT VARIABLES). 


“f [msglist| 
Forward the specified messages. The messages 
are inserted into the message, without alteration. 


“h 
Prompt for Subject line and To, Cc, and Bec 
lists. If the field is displayed with an initial 
value, it may be edited as if you had just typed 
it. 


“i string 
Insert the value of the named variable into the 
text of the Message. For example, ~A is 
equivalent to ’"i Sign.’ 


m [msglist| 
Insert the specified messages into the letter, 
shifting the new text to the right one tab stop. 
Valid only when sending a message while reading 
mail. 


Print the message being entered. 


Quit from input mode by simulating an 
interrupt. If the body of the message is not null, 
the partial message is saved in dead.letter. See 
"DEAD” (ENVIRONMENT VARIABLES) for a 
description of this file. 


“r filename 
~< filename 
~< !shell-command 
Read in the specified file. If the argument 
begins with an exclamation point (!), the rest of 
the string is taken as an arbitrary shell 
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command and is executed, with the standard 
output inserted into the message. 


“g string ... 
Set the subject line to string. 


“t name ... 
Add the given names to the To list. 


Vv 
Invoke a preferred screen editor on the partial 
message. See also “VISUAL” (ENVIRONMENT 
VARIABLES). 

“w filename 
Write the partial message onto the given file, 
without the header. 

"x 


Exit as with “q except the message is not saved 
in dead.letier. 


“| shell-command 
Pipe the body of the message through the given 
shell-command. If the shell-command returns a 
successful exit status, the output of the 
command replaces the message. 


ENVIRONMENT VARIABLES 


The following are environment variables taken from the 
execution environment and are not alterable within 
mailz. 


HOME= directory 
The user’s base of operations. 


MAILRC=filename 
The name of the start-up file. Default is 
$HOME/.mailrc. 


The following variables are internal maslr variables. 
They may be imported from the execution environment 
or set via the set command at any time. The unset 
command may be used to erase variables. 


allnet 
All network names whose last component (login 
name) match are treated as identical. This 
causes the meglist message specifications to 
behave similarly. Default is noallnet. See also 


may bs en 
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the alternates command and the ”metoo” 
variable. 


append 
Upon termination, append messages to the end 
of the mboz file instead of prepending them. 
Default is noappend. 


askce 
Prompt for the Cc list after message is entered. 
Default is noaskec. 


asksub 
Prompt for subject if it is not specified on the 
command line with the —s option. Enabled by 
default. 


autoprint 
Enable automatic printing of messages after 
delete and undelete commands. Default is 
noautoprint. 


bang 
Enable the special-casing of exclamation points 
{' in shell escape command lines as in v1(1). 
efault is nobang. 


cemd=shell-command 
Set the default command for the pipe command. 
No default value. 


conv=converston 

Convert uucp addresses to the specified address 
style. The only valid conversion now is internet, 
which requires a mail delivery program 
conforming to the RFC822 standard for 
electronic mail addressing. Conversion is 
disabled by default. See also “sendmail” and the 
—U command line option. 


ert=number 
Pipe messages having more than number lines 
through the command specified by the value of 
the "PAGER" variable (pg({1) by default). 
Disabled by default. 


Sj4e 
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DEAD=/filename 


debug 


dot 


The name of the file in which to save partial 
letters in case of untimely interrupt or delivery 
errors. Default is $HOME/dead.letter. 


Enable verbose diagnostics for debugging. 
Messages are not delivered. Default is 
nodebug. 


Take a period on a line by itself during input 
from a terminal as end-of-file. Default is nodot. 


EDITOR=shell-command 


The command to run when the edit or “e 
command is used. Default is ed(1). 


escape—c 


Substitute ¢ for the ~ escape character. 


folder—directory 


header 


hold 


ignore 


The directory for saving standard mail files. 
User specified file names beginning with a plus 
(+) are expanded by preceding the filename with 
this directory name to obtain the real] filename. 
If directory does not start with a slash (/), 
$HOME is prepended to it. In order to use the 
plus (+) construct on a matlz command line, 
"folder” must be an exported sA environment 
variable. There is no default for the “folder” 
variable. See also "outfolder” below. 


Enable printing of the header summary when 
entering matiz. Enabled by default. 


Preserve all messages that are read in the 
matlboz instead of putting them in the standard 
mboz save file. Default is nohold. 


Ignore interrupts while entering messages. 
Handy for noisy dial-up lines. Default is 
noignore. 
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ignoreeof 
Ignore end-of-file during message input. Input 
must be terminated by a period 0) on a line by 
itself or by the ~. command. Default is 


noignoreeof. See also ’dot” above. 


keep 
When the matlboz is empty, truncate it to zero 
length instead of removing it. Disabled by 
default. 

keepsave 


Keep messages that have been saved in other 
files in the matlboz instead of deleting them. 
Default is nokeepsave. 


MBOX==filename 
The name of the file to save messages which 
have been read. The xit command overrides this 


function, as does saving the message explicitly in 
another file. Default is SHOME/mbox. 


metoo 
If your login appears as a recipient, do not delete 
it from the list. Default is nometoo. 


LISTER=shell-command 
The command (and options) to use when listing 
the contents of the “folder” directory. The 
default is /s(1). 


onehop 

When responding to a message that was 
originally sent to several recipients, the other 
recipient addresses are normally forced to be 
relative to the originating author’s machine for 
the response. This flag disables alteration of the 
recipients’ addresses, improving efficiency in a 
network where all machines can send directly to 
all other machines (i.e., one hop away). 


outfolder 
Causes the files used to record outgoing 
messages to be located in the directory specified 
by the “folder” variable unless the pathname is 
absolute. Default is nooutfolder. See “folder” 
above and the Save, Copy, followup, and 
Followup commands. 
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page 
Used with the pipe command to insert a form 
feed after each message sent through the pipe. 
Default is nopage. 


PAGER==shell-command 
The command to use as a filter for paginating 
output. This can also be used to specify the 
options to be used. Default is pg(1). 


prompt=string 
Set the command mode prompt to. string. 
Default is "? ”. 


quiet 
Refrain from printing the opening message and 
version when entering matiz. Default is 
noquiet. 


record=filename 
Record all outgoing mail in filename. Disabled 
by default. See also "outfolder” above. 


save 
Enable saving of messages in dead.letter on 
interrupt or delivery error. See "DEAD” for a 
description of this file. Enabled by default. 


screen=number 
Sets the number of lines in a screen—full of 
headers for the headers command. 


sendmail=shell-command 
Alternate command for delivering messages. 
Default is mail(1). 


sendwait 
Wait for background mailer to finish before 
returning. Default is nosendwait. 


SHELL=shell-command 
The name of a preferred command interpreter. 
Default is sh(1). 


showto 
When displaying the header summary and the 
message is from you, print the recipient’s name 
instead of the author’s name. 
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sign== string 
The variable inserted into the text of a message 
when the “a (autograph) command is given. No 
default (see also “i (TILDE ESCAPES)). 


Sign=—string 
The variable inserted into the text of a message 
when the “A command is given. No default (see 
also “i (TILDE ESCAPES)). 


toplines=number 
The number of lines of header to print with the 
top command. Default is 5. 


VISUAL=shell-command 
The name of a preferred screen editor. Default 


is vt(1). 

FILES 
$HOME/.mailre personal start-up file 
$HOME/mbox secondary storage file 
/usr/mail/* post office directory 
/usr/lib/mailx/mailx.help* help message files 
/usr /lib/mailx/mailx.re global start-up file 
/tmp/R{emasx}* temporary files 

SEE ALSO 
mail(1), pg(1), Is(1). 

BUGS 


Where shell-command is shown as valid, arguments are 
not always allowed. Experimentation is recommended. 


Internal variables imported from the _ execution 
environment cannot be unset. 


The full internet addressing is not fully supported by 
matlz, The new standards need some time to settle 
down. 


Attempts to send a message having a line consisting only 
of a “‘.” are treated as the end of the message by mati(1) 
(the standard mail delivery program). 
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NAME 
make — maintain, update, and regenerate groups of 
programs 

SYNOPSIS 
make [-f makefile] [—p] {-i] [-k] [-s] [—r] [—n] (—b] 
[-e] [-m] [-t] [-d] [-q} | names 

DESCRIPTION 


The following is a brief description of all options and 
some special names: 


—f makefile Description file name. Makefile is assumed 


-m 


—t 


to be the name of a description file. A file 
name of — denotes the standard input. The 
contents of makefile override the built-in 
rules if they are present. 


Print out the complete set of macro 
definitions and target descriptions. 


Ignore error codes returned by invoked 
commands. This mode is entered if the 
fake target name -IGNORE appears in the 
description file. 


Abandon work on the current entry, but 
continue on other branches that do not 
depend on that entry. 


Silent mode. Do not print command lines 
before executing. This mode is also entered 
if the fake target name .SILENT appears in 
the description file. 


Do not use the built-in rules. 


No execute mode. Print commands, but do 
not execute them. Even lines beginning 
with an @ are printed. 


Compatibility mode for old makefiles. 


Environment variables override assignments 
within makefiles. 


Print a memory map showing text, data, 
and stack. This option is a no-operation on 
systems without the getu system call. 


Touch the target files (causing them to be 
up-to-date) rather than issue the usual 
commands. 


Debug mode. Print out detailed 
information on files and times examined. 
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-q Question. The make command returns a 
zero or non-zero status code depending on 
whether the target file is or is not up-to- 
date. 


-DEFAULT If a file must be made but there are no 
explicit commands or relevant built-in rules, 
the commands associated with the name 
-DEFAULT are used if it exists. 


-PRECIOUS 
Dependents of this target will not be 
removed when quit or interrupt are hit. 


SILENT Same effect as the —s option. 
IGNORE Same effect as the —i option. 


Make executes commands in makeftle to update one or 
more target names. Name is typically a program. If no 
~f option is present, makefile, Makefile, s.makefile, 
and s.Makefile are tried in order. If makefile is —, the 
standard input is taken. More than one — makefile 
argument pair may appear. 


Make updates a target only if its dependents are newer 
than the target. All prerequisite files of a target are 
added recursively to the list of targets. Missing files are 
deemed to be out of date. 


Makefile contains a sequence of entries that specify 
dependencies. The first line of an entry is a blank- 
separated, non-null list of targets, then a :, then a 
possibly null) list of prerequisite files or dependencies. 

ext following a ; and all following lines that begin with 
a tab are shell commands to be executed to update the 
target. The first line that does not begin with a tab or 
# begins a new dependency or macro definition. Shell 
commands may be continued across lines with the 
<backslash > <new-line> sequence. Everything printed 
by make (except the initial tab) is passed directly to the 
shell as is. Thus, 


echo a\ 
b 


will produce 
ab 
exactly the same as the shell would. 
Sharp (#) and new-line surround comments. 


The following makefile says that pgm depends on two 
files a.o and b.o, and that they in turn depend on their 
corresponding source files (a.c and b.c) and a common 
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file inel.h: 


pgm: a.o b.o 
cc a.o b.o -o pgm 
a.o: incl.h a.c 


ce —c ac 
b.o: incl.h b.c 
ce -—¢c bic 


Command lines are executed one at a time, each by its 
own shell. The first one or two characters in a command 
can be the following: —, @, —@, or @-. If @ is present, 
printing of the command is suppressed. If — is present, 
make ignores an error. A line is printed when it is 
executed unless the —s option is present, or the entry 
SILENT: is in makefile, or unless the initial character 
sequence contains a @. The —n option specifies printing 
without execution; however, if the command line has the 
string $(MAKE) in it, the line is always executed (see 
discussion of the MAKEFLAGS~ macro under 
Environment). The -t (touch) option updates the 
modified date of a file without executing any commands. 


Commands returning non-zero status normally terminate 
make. If the ~i option is present, or the entry 
-IGNORE: appears in makeftle, or the initial character 
sequence of the command contains -. the error is 
ignored. If the —k option is present, work is abandoned 
on the current entry, but continues on other branches 
that do not depend on that entry. 


The —b option allows old makefiles (those written for 
the old version of make) to run without errors. The 
difference between the old version of make and this 
version is that this version requires all dependency lines 
to have a (possibly null or implicit) command associated 
with them. The previous version of make assumed, if no 
command was specified explicitly, that the command was 
null. 


Interrupt and quit cause the target to be deleted unless 
the target is a dependent of the special] name 
-PRECIOUS. 


Environment 


The environment is read by make. All variables are 
assumed to be macro definitions and processed as such. 
The environment variables are processed before any 
makefile and after the internal rules; thus, macro 
assignments in a makefile override environment 
variables. The ~—e option causes the environment to 
override the macro assignments in a makefile. 
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The MAKEFLAGS environment variable is processed by 
make as containing any legal input option (except —f, 
—p, and —d) defined for the command line. Further, 
upon invocation, make “invents” the variable if it is not 
in the environment, puts the current options into it, and 
passes it on to invocations of commands. Thus, 
MAKEFLAGS always contains the current input 
options. This proves very useful for ‘‘super-makes’’. In 
fact, as noted above, when the —n option is used, the 
command $(MAKE) is executed anyway; hence, one can 
perform a make —n recursively on a whole software 
system to see what would have been executed. This is 
because the —n is put in MAKEFLAGS and passed to 
further invocations of $(MAKE). This is one way of 
debugging all of the makefiles for a software project 
without actually doing anything. 


Macros 


Entries of the form string! == string2 are macro 
definitions. String2 is defined as all characters up to a 
comment character or an  wumnescaped _new-line. 
Subsequent appearances of $(string1[:subst1=[subst2]|) 
are replaced by string2. The parentheses are optional if 
a single character macro name is used and there is no 
substitute sequence. The optional :subst1=subst2 is a 
substitute sequence. If it is specified, all non-overlapping 
occurrences of substi in the named macro are replaced 
by subst2. Strings (for the purposes of this type of 
substitution) are delimited by blanks, tabs, new-line 
characters, and beginnings of lines. An example of the 
use of the substitute sequence is shown under Ltbrartes. 


Internal Macros 


There are five internally maintained macros which are 
useful for writing rules for building targets. 


$* The macro $* stands for the file name part of the 
current dependent with the suffix deleted. It is 
evaluated only for inference rules. 


$@ The $@ macro stands for the full target name of 
the current target. It is evaluated only for 
explicitly named dependencies. 


$< The $< macro is only evaluated for inference rules 
or the .DDEFAULT rule. It is the module which is 
out-of-date with respect to the target es the 
“manufactured” dependent file name). Thus, in 
the .c.o rule, the $< macro would evaluate to the 
-c file. An example for making optimized .o files 
from .c files is: 
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cc -—c -O $c 
or: 


.C.0: 
ce -c -O $< 


$? The $? macro is evaluated when explicit rules from 
the makefile are evaluated. It is the list of 
prerequisites that are out of date with respect to 
the target; essentially, those modules which must 
be rebuilt. 


$% The $% macro is only evaluated when the target is 
an archive library member of the form lib(file.o). 
In this case, $@ evaluates to lib and $% evaluates 
to the library member, file.o. 


Four of the five macros can have alternative forms. 
When an upper case D or F is appended to any of the 
four macros, the meaning is changed to ‘‘directory part”’ 
for D and “file part” for F. Thus, $(@D) refers to the 
directory part of the string $@. If there is no directory 
part, ./ is generated. The only macro excluded from this 
alternative form is $?. The reasons for this are 
debatable. 


Suffixes 
Certain names (for instance, those ending with .o) have 
inferable prerequisites such as .c, .s, etc. If no update 
commands for such a file appear in makefile, and if an 
inferable prerequisite exists, that prerequisite is compiled 
to make the target. In this case, make has inference 
rules which allow building files from other files by 
examining the suffixes and determining an appropriate 
inference rule to use. The current default inference rules 
are: 


cc .c)6 sh shh” .c.0 Cc .0 ee 8.0 SO LY.0 
Ly .o lo J”. 
yc yc dic ca .c.a sa hh 


The internal rules for make are contained in the source 
file rules.c for the make program. These rules can be 
locally modified. To print out the rules compiled into 
the make on any machine in a form suitable for 
recompilation, the following command is used: 


make -fp — 2>/dev/null </dev/null 


The only peculiarity in this output is the (null) string 
which print{(3S) prints when handed a null string. 
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A tilde in the above rules refers to an SCCS file (see 
sccafile(4)). Thus, the rule .c’.o would transform an 
SCCS C source file into an object file (.o). Because the 
s. of the SCCS files is a prefix, it is incompatible with 
make’s suffix point-of-view. Hence, the tilde is a way of 
changing any file reference into an SCCS file reference. 


A rule with only one suffix fies .c:) is the definition of 
how to build z from z.c. In effect, the other suffix is 
null. This is useful for building targets from only one 
source file (e.g., shell procedures, simple C programs). 


Additional suffixes are given as the dependency list for 
-SUFFIXES. Order is significant; the first possible name 
for which both a file and a rule exist is inferred as a 
prerequisite. The default list is: 


-SUFFIXES: .o .c vy 1 ss 


Here again, the above command for printing the internal 
rules will display the list of suffixes implemented on the 
current machine. Multiple suffix lists accumulate; 
-SUFFIXES: with no dependencies clears the list of 
suffixes. 


Inference Rules 
The first example can be done more briefly. 


pgm: a.o b.o 
cc a.0 b.o —o pgm 
a.o b.o: inel.h 


This is because make has a set of internal rules for 
building files. The user may add rules to this list by 
simply putting them in the makefile. 


Certain macros are used by the default inference rules to 
permit the inclusion of optional matter in any resulting 
commands. For example, CFLAGS, LFLAGS, and 
YFLAGS are used for compiler options to ec(1), lez(1), 
and yace(1), respectively. Again, the previous method 
for examining the current rules is recommended. 


The inference of prerequisites can be controlled. The 
rule to create a file with suffix .o from a file with suffix 
-c is specified as an entry with .c.o: as the target and no 
dependents. Shell commands associated with the target 
define the rule for making a .o file from a .c file. Any 
target that has no slashes in it and starts with a dot is 
identified as a rule and not a true target. 


Libraries 
If a target or dependency name contains parentheses, it 
is assumed to be an archive library, the string within 
parentheses referring to a member within the library. 
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Thus lib(file.o) and $(LIB)(file.o) both refer to an 
archive library which contains file.o. (This assumes the 
LIB macro has been previously defined.) The expression 
$(LIB)(filel.o file2.0) is not legal. Rules pertaining to 
archive libraries have the form .XX.a where the XX is 
the suffix from which the archive member is to be made. 
An unfortunate byproduct of the current implementation 
requires the XX to be different from the suffix of the 
archive member. Thus, one cannot have lib(file.o) 
depend upon file.o explicitly. The most common use of 
the archive interface follows. Here, we assume the 
source files are all C type source: 
lib: lib(file1.o) lib(file2.o) lib(file3.o) 
@echo lib is now up-to-date 


4100) =e $(CFLAGS) $< 
ar rv $@ $*.0 
rm —f $*.o 


In fact, the .c.a rule listed above is built into make and 
is unnecessary in this example. A more interesting, but 
more limited example of an archive library maintenance 
construction follows: 
lib: lib(filel.o) lib(file2.o) lib(file3.o 
$(CC) -c $(CFLAGS) $(?:.0=.c 
ar rv lib $? 
rm $? @echo lib is now up-to-date 
.C.835 


Here the substitution mode of the macro expansions is 
used. The $? list is defined to be the set of object file 
names (inside lib) whose C source files are out-of-date. 
The substitution mode translates the .o to .c. 
(Unfortunately, one cannot as yet transform to .c’; 
however, this may become possible in the future.) Note 
also, the disabling of the .c.a: rule, which would have 
created each object file, one by one. This particular 
construct speeds up archive library maintenance 
considerably. This type of construct becomes very 
cumbersome if the archive library contains a mix of 
assembly programs and C programs. 


{MmlJakefile and s.[Mmlakefile 


SEE ALSO 


BUGS 


ec(1), cd(1), lex(1), sh(1), yacc(1), printf(3S), sccsfile(4). 


Some commands return non-zero status inappropriately; 
use —i to overcome the difficulty. File names with the 


=F 
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characters = : @ will not work. Commands that are 
directly executed by the shell, notably cd(1), are 
ineffectual across new-lines in make. The syntax 
fhethlel-c file2.o file3.0) is illegal. You cannot build 
lib(file.o) from file.o. The macro $(a:.0o=.c") does not 
work. 
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NAME 

man, manprog — print entries in this manual 
SYNOPSIS 

man [ options | [ section | titles 

/usr /lib/manprog file 
DESCRIPTION ; 


Man locates and prints the entry of this manual named 
title in the specified section. (For historical reasons, the 
word ‘‘page”’ is often used as a synonym for “entry”’ 
this context.) The tttle is entered in lower case. The 
section number may not have a letter suffix. If no 
section is specified, the whole manual is searched for 
title and all occurrences of it are printed. Opttons and 
their meanings are: 


—t Typeset the entry in the default format 
(8. eae 
-8 Aipee the entry in the small format 
« 9"). 


-—T4014 ey Nhe typeset output on a Tektronix 
4014 terminal using tc(1). 
—Ttek Same as —T4014. 


-Tvp Print the typeset output on a Versatec 
printer; this option is not available at all 
sites. 


—Tterm Format the entry using nroff and print it on 
the standard output (usually, the terminal); 
term is the terminal type ee term(5) and 
the explanation below); for a list of 
recognized values of term, type help 
term2. The default value of term is 450. 

—w Print on the standard output only the path 
names of the entries, relative to [use /mian, 
or to the current directory for —d option. 

-d Search the current directory rather than 
/usr/man, requires the full file name (e.g., 
cu.le, rather than just cu). 

-12 Indicates that the manual entry is to be 
produced in 12-pitch. May be used when 
$TERM (see below) is set to one of 300, 
300s, 450, and 1620. (The pitch switch on 
the DASI 300 and 300s terminals must be 
manually set to 12 if this option is used.) 

—c Causes man to invoke col(1); note that 
col(1) is invoked automatically by man 
unless term is one of 300, 300s, 450, 37, 
4000a, 382, 4014, tek, 1620, and X. 
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-y Causes man to use the non-compacted 
version of the macros. 


The above options other than —d, -—ce, and —y are 
mutually exclusive, except that the —s option may be 
used in conjunction with the first four —T options 
above. Any other opttons are passed to troff, nroff, or 
the man(5) macro package. 


When using nroff, man examines the environment 
variable $TERM (see envtron(5)) and attempts to select 
options to nroff, as well as filters, that adapt the output 
to the terminal being used. The —Tterm option 
overrides the value of $TERM; in particular, one should 
use —Tlp when sending the output of man to a line 
printer. 


Section may be changed before each title. 
As an example: 
man man 


would reproduce on the terminal this entry, as well as 
any other entries named man that may exist in other 
sections of the manual, e.g., man(5). 


If the first line of the input for an entry consists solely of 
the string: 
Ne zr 

where z is any combination of the three characters c, e, 
and t, and where there is exactly one blank between the 
double quote (") and z, then man will preprocess its 
input through the appropriate combination of ecw(1), 
eqn(1) (negn for nroff) and tbi(1), respectively; if eqn or 
negn are invoked, they will automatically read the file 
/usr/pub/eqnchar (see egnchar(5)). 


The man command executes manprog that takes a file 
name as its argument. Manprog calculates and returns a 
string of three register definitions used by the formatters 
identifying the date the file was last modified. The 
returned string has the form: 


—rdday —rmmonth —ry year 


and is passed to nroff which sets this string as variables 
for the man macro package. Months are given from 0 to 
11, therefore month is always 1 less than the actual 
month. The man macros calculate the correct month. If 
the man macro package is invoked as an option to 
nroff/troff (i.e, nroff -man file), then the current 
day /month/year is used as the printed date. 
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FILES 
/usr/man/u_man/man(1-8] directories for source 
iles 
/usr/man/local /man{1-8}/* local additions 
/usr/lib/manprog calculates modification 
dates of entries 
SEE ALSO 
ew(1), eqn(1), nroff(1), thl(1), te(1), troff(1), environ(5), 
man(5), term(5). 
BUGS 


All entries are supposed to be reproducible either on a 
typesetter or on a terminal. However, on a terminal 
some information is necessarily lost. 
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NAME 

mesg — permit or deny messages 
SYNOPSIS 

mesg [n | | y | 
DESCRIPTION 


Mesg with argument n forbids messages via write(1) by 
revoking non-user write permission on the user’s 
terminal. Mesg with argument y reinstates permission. 
All by itself, mesg reports the current state without 
changing it. 

FILES 
/dev/tty* 

SEE ALSO 
write(1). 

DIAGNOSTICS 
Exit status is 0 if messages are receivable, 1 if not, 2 on 
error. 
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mkdir, mkdirs — make a directory 


SYNOPSIS 


mkdir dirname ... 
mkdirs dirname ... 


DESCRIPTION 


SEE ALS 


Mkdtr creates specified directories in mode 777 (possibly 
altered by umask(1)). Standard entries, ., for the 
directory itself, and .., for its parent, are made 
automatically. 


Mkdir requires write permission in the parent directory. 


Mkditrs creates the specified directory by using mkdir, as 
well as all nonexistent parent directories. All diagnostics 
are those of mkdir. If no directories are made, mkdir is 
silent and has an exit status of 0. 


O 
sh(1), rm(1), umask(t). 


DIAGNOSTICS 


Mkdir returns exit code 0 if all directories were 
successfully made; otherwise, it prints a diagnostic and 
returns non-zero. 


NAME 


MKFS(1M) 


mkfs — construct a file system 


SYNOPSIS 


etc/mkfs special { —O | blocks[:i-nodes| 
ap blocks/cy]] 

etc/mkfs special {| —O | proto (gap blocks/cyl| 
/etc/mkfs special 


DESCRIPTION 


Mkfs constructs a file system by writing on the special 
file according to the directions found in the remainder of 
the command line. The command waits 10 seconds 
before starting to construct the file system. If the second 
argument is given as a string of digits, mkfs builds a file 
system with a single empty directory on it. The size of 
the file system is the value of blocks interpreted as a 
decimal number. This is the number of physical (512- 
byte) disk blocks the file system will occupy. The boot 
program is left uninitialized. If the optional number of i- 
nodes is not given, the default is the number of logical 
blocks divided by 4 (rounded down); i-nodes are 
allocated in groups of 16. 


If the second argument is a file name that can be 
opened, mkfs assumes it to be a prototype file proto, and 
will take its directions from that file. The prototype file 
contains tokens separated by spaces or new-lines. The 
first token is the name of a file to be copied onto block 
zero as the bootstrap program. The second token is a 

number specifying the size of the created file system in 
phystcal disk blocks. Typically it will be the number of 
blocks on the device, perhaps diminished by space for 
swapping. The next token is the number of i-nodes in 
the file system. The maximum number of i-nodes 
configurable is 65500. The next set of tokens comprise 
the specification for the root file. File specifications 
consist of tokens giving the mode, the user ID, the group 
ID, and the initial contents of the file. The syntax of the 
contents field depends on the mode. 


The mode token for a file is a 6-character string. The 
first character specifies the type of the file. (The 
characters —bed specify regular, block special, character 
special and directory files respectively.) The second 
character of the type is either u or — to specify set-user- 
id mode or not. The third is g or — for the set-group-id 
mode. The rest of the mode is a three digit octal 
number giving the owner, group, and other read, write, 
execute permissions (see chmod(1)). 
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Two decimal number tokens come after the mode; they 
specify the user and group IDs of the owner of the file. 


If the file is a regular file, the next token is a pathname 
whence the contents and size are copied. If the file is a 
block or character special file, two decimal number 
tokens follow which give the major and minor device 
numbers. If the file is a directory, mkfs makes the 
entries . and .. and then reads a list of names and 
(recursively) files specifications for the entries in the 
directory. The scan is terminated with the token $. 


A sample prototype specification follows: 


/stand/ diskboot 

4872 110 

d--777 31 

usr d--777 31 
sh -~~-755 31 /bin/sh 
ken oe 6 1 


bo b--6443100 
- c--6443100 


$ 


In both command syntaxes, the rotational gap and the 
number of blocks/cyl can be specified. The default gap 
size is 7. The default blocks eyimdst is 400. The 
default will be used if the supplied gap and blocks/cyl 
are considered illegal values or if a short argument count 
occurs. 


The —O option makes a file system with a free list 
instead of a bit map. 


Special must be a disk slice. The third form of the mkfs 
command extracts the slice size from the volume home 
block and creates a file system the same size; this third 
option cannot be used where there are overlapping 
partitions. The number of i-nodes is the number of 
logical blocks divided by 4. Optimal values for gap size 
and blocks/cylinder are calculated; these may not be 7 
and 400. 


SEE ALSO 


BUGS 


chmod(1), dir(4), fs(4). 
MightyFrame Administrator’s Reference Manual. 
MiniFrame Admintstrator’s Manual. 


If a prototype is used, there is no way to specify links or 
cluster size. 
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NAME 

mkhosts — make node name commands 
SYNOPSIS 

/etc/mkhosts 
DESCRIPTION 


Mkhosts makes the simplified forms of the remd(1N) and 
rlogin(IN) commands. For each node listed in 
/etc/hosts, mkhosts creates a link to 
/usr/local/bin/remd in /usr/hosts. Each _link’s 
name is the same as the node’s official name in 
/etc/hosts. 


SEE ALSO 
remd (1N), rlogin(1N). 
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NAME 

mkifile — make an ifile from an object file 
SYNOPSIS 

/etc/Iddrv/mkifile a.out ifile 
DESCRIPTION 


Mkifile takes an object module and writes in sfile a line 
of the form 


symbol = Oxvalue 
For each external symbol in the object module this ifile 
can be used as an argument to Id(1) as an absolute 
symbol table against which other modules may be linked. 
Mkifile is used with loadable drivers to provide the 
symbols for the currently running CTIX. 
SEE ALSO 
ld(1), Iddrv(1M), Ideeprom(1M). 
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MKLOST+FOUND (1M) 


NAME 
mklost+found — make a lost+found directory for fsck 


SYNOPSIS 
/ete/mklost+found 


DESCRIPTION 
A directory Jlost+found is created in the current 
directory and a number of empty files are created therein 
and then removed so that there will be empty slots for 
fsck(M). This command should be run immediately after 
first mounting a newly created file system. 


SEE ALSO 
fsck(1M), mkfs(1M) 


BUGS 
Should be done automatically by mk/fs. 


NAME 


MKNOD(1M) 


mknod — build special file 


SYNOPSIS 


/etc/mknod name c | b major minor 
/etc/mknod name p 


DESCRIPTION 


Mknod makes a directory entry and corresponding i-node 
for a special file. The first argument is the name of the 
entry. In the first case, the second is b if the special file 
is block-type (disks, tape) or ¢ if it is character-type 
(other devices). The last two arguments are numbers 
specifying the major device type and the minor device 
(e.g., unit, drive, or line number), which may be either 
decimal or octal. 


The assignment of major device numbers is specific to 
each system. They have to be dug out of the system 
source file conf.c. 


Mknod can also be used to create fifo’s (a.k.a. named 
pipes) (second case in SYNOPSIS above). 


SEE ALSO 


mknod(2). 
MightyFframe Administrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 
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NAME 
mktpy, mvtpy — install or relocate a PT or GT local 
printer 

SYNOPSIS 
/usr/local/bin/mktpy [namel [name?2 [tty]]] 
/usr/local/bin/mvtpy name tty n 

DESCRIPTION 
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To install a PT or GT local printer initially, the system 
administrator must use the /[padmin(1) command. The 
administrator must use the —l flag to ensure that the 
spooling system knows that the printer is attached to a 
login terminal. If this is not done, the printers will be 
attached to random devices at boot time, and behavior is 
undefined. 


Mktpy is used to inform the /p(1) spooling system of the 
location of a printer that is attached to a PT or GT and 
to enable(1) the printer to accept print requests. Mktpy 
installs a printer on an RS-422 terminal’s local port. 
Mvtpy updates a mktpy installation by changing the 
device association when the terminal’s device number 
changes. The device number may change each time the 
system or the terminal is powered off and on. 


The mktpy command accepts the names of one or two 
printers as arguments. If no arguments are given, it will 
prompt for the name of two printers. As an argument, 
the null string ”” must be used in the first argument 
position if only one printer exists and is attached to the 
second port. In response to a prompt, a <cr> indicates 
that no printer is attached to the indicated port. 


If mktpy is run and the imdicated printer is already 
attached to another tty device, the location of that 
printer is not changed and a warning message is printed. 


If the command is being executed to inform the system 
of a printer attached to a terminal other than the 
terminal from which the command is being run, then the 
printers must be specified as arguments (with a null 
string, if necessary, as a place holder). The tty line to 
which the printer’s host terminal is attached must be 
specified as the third argument. 


The mvtpy command is most commonly used when a PT 
or GT has been powered off and then on again and the 
tty number of the PT or GT has changed. The system 
needs to be informed of the tty line that should receive 
the print requests. Before running mvtpy, the new tty 
number must be determined. Name is the name of the 
printer, name2 is the tty number of the new tty, and n is 


“4 
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the port on the PT or GT to which the printer is 
attached; n must be either 1 or 2. Mutpy processes these 
arguments and issues an /padmin(1) command to move 
the specified printer to the indicated tty line. Diagnostics 
are from lpadmin. 


For the convenience of users, a mktpy login is provided. 
The mktpy login executes mktpy for the terminal where it 
is executed and prompts for printer names. 


EXAMPLES 


NOTES 


To install two printers on the same tty: 
mktpy DIABLO EPSON 

To install a printer on the second port of another tty: 
mktpy ” QUME tty256 


To tell the system that the tty number of the terminal 
to which a printer is attached has changed: 


mvtpy QUME tty260 


Only PTs or GTs that are on cluster lines can have 
printers attached to the serial ports. GTs have two 
serial ports and PTs have one serial port. Printers 
attached to PTs are considered to be attached to the 
first port. For each terminal /dev/ttynnn on the 
system, two other character special files exist, 
dev/tpannn and /dev/tpbnnn. These devices refer 
to the first and second serial ports respectively on the 
matching terminal. 


FILES 
/dev/ttynnn Name of tty 
/dev/tpa First serial port of /dev/tty nnn 
/dev/tpb Second serial port of /dev/ttynnn 
/tmp/mkt[12]* Temporary files to hold printer 
status for mktpy 
/tmp/mvt* Temporary file to hold printer 
status for mvtpy 
/dev/tp/* 
SEE ALSO 
accept(1), disable(1), enable(1), Ip(1),  lpadmin(1), 
Ipsched(1), reject(1), tp(7). 
DIAGNOSTICS 


Generally self explanatory. ‘‘LP doesn’t know sazxr” if 
the printer has not been created yet. Check spelling of 
printer name or see system administrator. 
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WARNINGS 
The command 


mktpy ” ” ttyxxx 
has no effect; it does not prompt for input. 
Printing to the second port of a PT is not recommended. 


MKTUNEDRV( 1M) 


NAME 
mktunedrv — make a loadable driver for tunable 
variables 

SYNOPSIS 
/ete/lddrv/mktunedrv 

DESCRIPTION 


When called by /etc/drvload, mktunedriver extracts 
the names and values of certain tunable variables from 
the /etc/system file, reades the !FILENAMES and 
ITUNEABLES sections of the jete/ System file, and 
constructs a C program to be loaded in to the kernel 
using the Iddrv(1M) program. This C program modifies 
the values of kernel variables, thus changing the 
defaults. 


The tunable driver created by this program should be 
the first loadable driver entry in the jeteldrvioud file. 


The following variables can be tuned in the !TUNEABLES 
section of the /ete/system file: 


dsabldbg 0 enable the kernel debugger. 
1 disable the kernel debugger. 

cl_deflines the number of channels for RS-422 
lines; each channel can have up to 8 
terminals. 

cl_defdrops the number of terminals per channel for 
RS-422 lines. 

cl_defdrive the disk drive to be used to obtain RS- 


422 boot images. This is expressed as a 
decimal number equivalent to the 16-bit 
device number, right-shifted four bits. 
For example, cld1 (0000 0001 0001 
0000) is specified as 17. 


vt_defent the number of virtual terminals for 
Ethernet. 
net_mbsize the size of the network buffer pool. 


net_tcpdebug the number of TCP trace buffers. 


dirtosz the system-wide value for the point at 
which the system stops caching and 
begins direct I/O. 
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FILES / 
/etc/system 
/etc/drvload 


SEE ALSO 
Iddrv(1M), system(4). 
MightyFrame Administrator’s Reference Manual. 
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MM(1) 


NAME 
mm, osdd, checkmm -— print/check documents formatted 
with the MM macros 


SYNOPSIS 
mm [ options | [ files | 
osdd |{ options | | files | 
checkmm | files | 


DESCRIPTION 

Mm can be used to type out documents using nroff and 
the MM text-formatting macro package. It has options 
to specify preprocessing by ¢b/(1) and/or negn (see 
negn(1)) and postprocessing by various terminal-oriented 
output filters. The proper pipelines and the required 
arguments and flags for nroff and MM are generated, 
depending on the options selected. 


Osdd is equivalent to the command mm —mosd. For 
more information about the OSDD adapter macro 
package, see mosd(5). 


Options for mm are given below. Any other arguments 
or flags (e.g., -rC3) are passed to nroff or to MM, as 
appropriate. Such options can occur in any order, but 
they must appear before the files arguments. If no 
arguments are given, mm prints a list of its options. 


—Tterm Specifies the type of output terminal; for a list 
of recognized values for term, type help 
term2. If this option is not used, mm will 
use the value of the shell variable $TERM 
from the environment (see profile(4) and 
environ(5)) as the value of term, if $TERM is 
set; otherwise, mm will use 450 as the value 
of term. If several terminal types are 
specified, the last one takes precedence. 

-12 Indicates that the document is to be produced 
in 12-pitch. May be used when $TERM is set 
to one of 300, 300s, 450, and 1620. (The 
pitch switch on the DASI 300 and 300s 
terminals must be manually set to 12 if this 
option is used.) 

—e Causes mm to invoke col(1); note that col(1) 
is invoked automatically by mm unless term is 
one of 300, 300s, 450, 37, 4000a, 382, 
4014, tek, 1620, and X. 


-e Causes mm to invoke neqn; also causes neqn 
to read the /usr/pub/eqnchar file (see 
eqnchar(5)). 
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-t Causes mm to invoke éb/(1). 
-E Invokes the —e option of nroff. 
-y Causes mm to use the non-compacted version 


of the macros (see mm(5)) 


As an example (assuming that the shell variable $TERM 
is set in the environment to 450), the two command 
lines below are equivalent: 

mm —-t —rC3 -12 ghh* 

tbl ghh* | nroff -cm -T450-12 -h -rC3 
Mm reads the standard input when — is specified instead 
of any file names. (Mentioning other files together with 
— leads to disaster.) This option allows mm to be used 
as a filter, e.g.: 


cat dws | mm — 


Checkmm is a program for checking the contents of the 
named files for errors in the use of the Memorandum 
Macros, missing or unbalanced negn delimiters, and 
-EQ/.EN pairs. ag The user need not use the 
checkeg program (see neqn(1)), Appropriate messages 
are produced. The program skips all directories, and if 
no file name is given, standard input is read. 


( HINTS 
1. Mm invokes nroff with the —h flag. With this 


flag, nroff assumes that the terminal has tabs set 
every 8 character positions. 

2. Use the —olist option of nroff to specify ranges 
of pages to be output. Note, however, that mm, 
if invoked with one or more of the —e, —t, and 
— options, together with the —olist option of 
nroff may cause a harmless “broken pipe”’ 
diagnostic if the last page of the document is not 
specified in [tst. 

3. If you use the —s option of nroff (to stop 
between pages of output), use line-feed (rather 
than return or new-line) to restart the output. 
The —s option of nroff does not work with the 
-—c option of mm, or if mm automatically 
invokes col(1) (see —c option above). 

4. If you lie to mm about the kind of terminal its 
output will be printed on, you'll get (often 
subtle) garbage; however, if you are redirecting 
output into a file, use the —T37 option, and 
then use the appropriate terminal filter when 
you actually print that file. 
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ALSO 
col(1), env) ent greek(1), nroff(1), tbl(1), 


profile(4), mm(5), term(5). 
DIAGNOSTICS 
mm “mm: no input file’ if none of the arguments 
is a readable file and mm is not used as a 
filter. 


checkmm “Cannot open filename” if file(s) is 
unreadable. The remaining output of the 
program is diagnostic of the source file. 


NAME 


MMT(1) 


mmt, mvt — typeset documents, view graphs, and slides 


SYNOPSIS 


mumt [| options | [| files ] 
mvt [ options | { files ] 


DESCRIPTION 


HINT 


These two commands are very similar to mm(1), except 
that they both typeset their input via troff(1), as 
opposed to formatting it via nroff; mmt uses the MM 
macro package, while mvt uses the Macro Package for 
View Graphs and Slides. These two commands have 
options to specify preprocessing by tb/(1) and/or egn(1). 
The proper pipelines and the required arguments and 
flags for troff(1) and for the macro packages are 
generated, depending on the options selected. 


Options are given below. Any other arguments or flags 
(e.g., —rC3) are passed to froff(1) or to the macro 
package, as appropriate. Such options can occur in any 
order, but they must appear before the files arguments. 
If no arguments are given, these commands print a list of 
their options. 


—e Causes these commands to invoke egn(1); 
also causes eqn to read the 
/usr/pub/eqnchar file (see egnchar(5)). 

—t Causes these commands to invoke ¢bi(1). 
-Tvp Directs the output to a Versatec printer; this 
option is not available at all sites. 

-—T4014 Directs the output to a Tektronix 4014 
terminal via the te(1) filter. 

-Ttek Same as —-T4014. 

~a Invokes the —a option of troff(1). 

~-y Causes mmi to use the non-compacted 
version of the macros (see mm(5)). No effect 
for mut. 


These commands read the standard input when — is 
specified instead of any file names. 


Mot is just a link to mmt. 


Use the —olist option of troff(1) to specify ranges of 
pages to be output. Note, however, that these 
commands, if invoked with one or more of the —e, —t, 
and — options, together with the —olist option of troff(1) 
may cause a harmless “broken pipe”’ diagnostic if the 
last page of the document is not specified in list. 
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SEE ALSO 
env(1), eqn(1), mm(1), tb 
environ(5), mm(5), mv( ). 
DIAGNOSTICS 
““m ae no input file” 
readab 


1) 


1(1), te(1), troff(1), profile(4), 


if none of the arguments is a 


e file and the command is not used as a filter. 


NAME 


MORE(1) 


more, page — text perusal 


SYNOPSIS 


more [ —cdflsu —n | { +linenumber 
[ ee | ; Se mn J 


age | —cedflsu | | -n | | +/] | +/pattern | 
Taam he | 


DESCRIPTION 


More and page display text a screenful at a time. Page 
clears the screen before each screenful; otherwise page 
and more are identical. Henceforth we refer just to 
more. 


When the screen is full, more prints the string 
““_ _More~—-—”’. If input is a file, more indicates how 
much of the file has been read. To display the next 
screenful, type a space. To display a list of commands, 
type an “‘h’’. 

More treats underlining and form feeds (“L) specially; 
otherwise it passes along its input unmodified. If your 
terminal has an underline mode or some other standout 
mode, more uses this mode to display underlined text. If 
a file begins with a form feed, more clears the screen 
before displaying the file. Subsequent form feeds cause 
more to pause. 

If the standard output is not a terminal, more does not 
pause between screenfuls. 


To make more pause in the middle of a screenful, type 
QUIT (normally code—\). Some text is lost when you do 
this, and you may terminate whatever program is piping 
to more. 


These are the options. 


—n Display n lines instead of a screenful. 

-¢ Avoid scrolling. More begins each screenful at 
the top of the screen and erases each line as it is 
needed. 

-d Prompts user with ‘Hit space to continue, 
Rubout to abort” at the end of each screenful. 

-f Count file lines, rather than screen lines. 

~l No special treatment for form feeds. 

—s Suppress all but one of each sequence of blank 
lines. Useful with nroff. 

~u No special handling of underlining. 
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+linenumber 
Begin displaying the file at line number /. 


+/pattern 
Search for pattern and begin displaying the file 
two lines before it. Pattern is a _ regular 
expression; it follows the same rules as does a 
search in ez(1). 


If the program is invoked as page, then the screen is 
cleared before each screenful is printed (but only if a full 
screenful is being printed), and k — 1 rather than k - 2 
lines are printed in each screenful, where k is the number 
of lines the terminal can display. 


To supply options automatically, put the options in the 
MORE environment variable. Here’s an example for 
the Bourne Shell: 


MORE = ’-s -d’ 


More looks at the TERM environment variable to find 
what kind of terminal you’re using and at the 
TERMCAP environment variable to find how the 
terminal works. If TERMCAFP is not set, more 
examines /ete/termcap. 


More resets terminal modes. This permits character (as 
opposed to line) commands and limits echoing of 
commands. 


More looks in the environment variable MORE to pre-set 
any flags desired. For example, if you prefer to view 
files using the -c mode of operation, the esh command 
setenv MORE -ce or the sh command sequence 
MORE=’-c' ; export MORE would cause all invocations 
of more , including invocations by programs such as man 
and msgs , to use this mode. Normally, the user will 
place the command sequence which sets up the MORE 
environment variable in the .cshre or .profile file. 


If more is reading from a file, rather than a pipe, then a 
percentage is displayed along with the --More-- prompt. 
This gives the fraction of the file (in characters, not 
lines) that has been read so far. 


Other sequences which may be typed when more pauses, 
and their effects, are as follows (1 is an optional integer 
argument, defaulting to 1) : 


? <space> 
display * more lines, (or another screenful if no 
argument is given) 


‘D 


t /expr 


in 
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display 11 more lines (a “scroll’”). If is given, 
then the scroll size is set to ?. 


same as “D (code-D) 


same as typing a space except that 1, if present, 
becomes the new window size. 


skip ¢ lines and print a screenful of lines 
skip ¢ screenfuls and print a screenful of lines 
Exit from more. 

Display the current line number. 

Start up the editor vf at the current, line. 


Help command; give a description of all the 
more commands. 


search for the #-th occurrence of the regular 


expression ezpr. If there are less than 1 


occurrences of expr, and the input is a file 
(rather than a pipe), then the position in the file 
remains unchanged. Otherwise, a screenful is 
displayed, starting two lines before the place 
where the expression was found. The user’s 
erase and kill characters may be used to edit the 
regular expression. Erasing back past the first 
column cancels the search command. 


search for the #-th occurrence of the last regular 
expression entered. 


(single quote) Go to the point from which the 
last search started. If no search has been 
performed in the current file, this command goes 
back to the beginning of the file. 


{command 


invoke a shell with command. The characters 
‘%’ and ‘!’ in “command” are replaced with the 
current file name and the previous shell 
command respectively. If there is no current file 
name, ‘%’ is not expanded. The sequences 
“"\%" and "\!" are replaced by "%” and "!” 
respectively. 


skip to the #-th next file given in the command 
line (skips to last file if n doesn’t make sense) 


skip to the 1t-th previous file given in the 
command line. If this command is given in the 
middle of printing out a file, then more goes 
back to the beginning of the file. If ¢ doesn’t 
make sense, more skips back to the first file. If 
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more is not reading from a file, the bell is rung 
and nothing else happens. 


f display the current file name and line number. 


:q or :Q 
exit from more (same as q or Q). 


(dot) repeat the previous command. 


The commands take effect immediately, i.e., it is not 
necessary to type a carriage return. Up to the time 
when the command character itself is given, the user 
may hit the line kill character to cancel the numerical 
argument being formed. In addition, the user may hit 
the erase character to redisplay the --More—-(xx%) 
message. 


At any time when output is being sent to the terminal, 
the user can hit the quit key (normally code—\). More 
will stop sending output, and will display the usual — 
More-- prompt. The user may then enter one of the 
above commands in the normal manner. Unfortunately, 
some output is lost when this is done, due to the fact 
that any characters waiting in the terminal’s output 
queue are flushed when the quit signal occurs. 


The terminal is set to noecho mode by this program so 
that the output can be continuous. What you type will 
thus not show on your terminal, except for the i. and ! 
commands. 


If the standard output is not a teletype, then more acts 
just like cat, except that a header is printed before each 
file (if there is more than one). 

A sample usage of more in previewing nroff output 
would be 


nroff —ms +2 doc.n | more -s 


AUTHOR 


Eric Schienbrood, minor revisions by John Foderaro and 
Geoffrey Peck 


FILES 
/etc/termcap Terminal data base 
/usr/lib/more.help Help file 

SEE ALSO 


csh(1), man(1), script({1), sh(1), termcap(4), environ(5). 
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NAME 

mount, umount — mount and dismount file system 
SYNOPSIS 

/ete/mount | special directory [ —r | ] 


/etc/umount special 


DESCRIPTION 


FILES 


Mount announces to the system that a removable file 
system is present on the device special. The directory 
must exist already; it becomes the name of the root of 
the newly mounted file system. 


These commands maintain a table of mounted devices. 
If invoked with no arguments, mount prints the table. 


The optional last argument indicates that the file is to 
be mounted read-only. Physically write-protected and 
magnetic tape file systems must be mounted in this way 
or errors will occur when access times are updated, 
whether or not any explicit write is attempted. 

Umount announces to the system that the removable file 
system previously mounted on device special is to be 
removed. 

If the file system is marked as being dirty, mount will 
mount the file system for read only. The file system 
should be unmounted, fixed with fsck(1M), and then 
remounted. 


/etc/mnttab mount table 


SEE ALSO 


setmnt(1M), mount(2), mnttab(4). 


DIAGNOSTICS 


BUGS 
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Mount issues a warning if the file system to be mounted 
is currently mounted under another name. 


Umount complains if the special file is not mounted or if 
it is busy. The file system is busy if it contains an open 
file or some user’s working directory. 


Some degree of validation is done on the file system; 
however, it is generally unwise to mount garbage file 
systems. 
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NAME 
mvdir — move a directory 

SYNOPSIS 
/etc/mvdir dirname name 

DESCRIPTION 
Mvdir moves directories within a file system. Dirname 
must be a directory; name must not exist unless it is a 
directory. Name may be a subset of dirname, provided 
the directory is not moved onto itself (mvdir /x/y /x is 
possible, but /x/y cannot be moved to /x/y/z). 
Only super-user can use mvdir. 

SEE ALSO 


mkdir(1). 
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NAME 
ncheck — generate names from i-numbers 

SYNOPSIS 
/ete/ncheck | —i numbers | { -a ] | -s | [ file 
system | 

DESCRIPTION 


Neheck with no argument generates a path-name vs. L- 

number list of all files on a set of default file systems. 

Names of directory files are followed by /.. The —~i 

option reduces the report to only those files whose i- - 
numbers follow. The —a option allows printing of the 

names . and .., which are ordinarily suppressed. The —s 

option reduces the report to special files and files with 
set-user-ID mode; it is intended to discover concealed 
violations of security policy. 


A file system may be specified. 


The report is in no useful order, and probably should be 
sorted. 


SEE ALSO 
bcheck(1M), fsck(1M), sort(1). 


DIAGNOSTICS 
When the file system structure is improper, ?? denotes 
the ‘“‘parent’”’ of a parentless file and a path-name 
beginning with ... denotes a loop. 
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NAME 

netman — form-based network management 
SYNOPSIS 

/etc/netman 
DESCRIPTION 
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Netman helps the system administrator monitor and 
configure the network. It is a form- and menu-based 
program that can run on a wide variety of terminals. 
Netman arranges for the installation and removal of 
servers, modifies system and_ personal network 
configuration files, and displays network information. 
Any user can use netman, but if it is not run by the 
superuser, certain privileged options will not appear on 
the “Administration” menu. 


Netman requires that the TERM environment variable be 
set to the terminal’s type. TERM is used as an index 
into /etc/termcap (see termcap(4)) and 
/usr/lib/kbmap. 


Netman displays a series of pop-up windows. It explains 
keyboard usage for each window as needed, but it is 
worth knowing some standard keys in advance. The 
following table gives basic function keys, their 
alternatives for terminals without labeled function keys, 
and their standard meanings: 

Key Alternate Meaning 

J Return Move selection cursor down 
or to next item. Wraps from 
end to beginning. 

t (none) Move selection cursor up or 
to previous item. Wraps 
from beginning to end. In 
text windows, scroll down 
text. 

Next Line Feed Next window. If the 
selection cursor is present, 
choose the selected option. 
If no selection cursor, return 
to the previous window. In 
text windows, scroll up text. 

Cancel Control-X Return to previous window. 
Use this to cancel an option 
you have already selected. If 
you Cancel the “Network 
Management” window, 
netman terminates. 
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Help ESC ? Print help window for 
current window. 


An invalid keystroke prints a window showing which 
keystrokes are valid for the current window. 


At any time, the interrupt character (normally generated 
by the Delete key) terminates netman. 


Here is the hierarchy of windows: 


Network Management 
Machine status 


° Displays status of network nodes. 
Network Users 
e Displays users on various network nodes. 


The display is actually a menu: you can 
choose a user and display the processes he 
or she is running. 

Administration 


e Modify configuration of the network. 
Add an Equivalent User 


e Declare another user equivalent to 
yourself. 
Delete an Equivalent User 


° Remove a user from your list of 
equivalent users. Use the arrow keys 
to step through the list or use the 
Bound key to display the complete 


list. 
Add an Equivalent Machine 
® Declare another node equivalent to 


yours: a user on the other machine is 

equivalent to a user with the same 

name on your machine. Only the 

superuser has access to this option. 
Delete an Equivalent Machine 


° Remove a node from your list of 
equivalent nodes. Use the arrow keys 
to step through the list or use the 
Bound key to display the complete 
list. Only the superuser has access to 
this option. 

Add a New Network Service 


° Turn a server on. Choose from the 
Remote Login Server (supports 
rlogin(1N)), the Remote Command 
Server (supports remd(1N) and 
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rep(1N)), Remote Status Server 
(supports rwho(1N) and netstat(1N)), 
the TELNET Protocol Server (supports 
telnet(1N)), or the File Transfer 
Protocol Server (supports ftp(1N)). 
Only the superuser has access to this 
option. 

Remove a Current Network Service 

e Turn a server off. Converse of “‘Add a 

Current Network Service.” 

Add a New Host 


° Add to the list of nodes known to 
the local node. See hosts(4N) for 
an explanation of the various 


fields. 
Change a Host Entry 
° Change or delete the description of 


one of the nodes on the network. 
Network Interface Statistics 


e List’ statistics for local node’s interface 
with network. 
Active Connections 
Network Interfaces 
Memory Usage 
Routing Tables 
Protocol Statistics 


FILES jete/ 
etc/re 
/etc/hosts 
/etc/hosts.equiv. 
$HOME/ .rhosts 
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NAME 


NETSTAT (1N) 


netstat — show network status 


SYNOPSIS 


netstat { —Aaimnrs | | interval | | system | | core | 


DESCRIPTION 
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The netstat command symbolically displays the contents 
of various network-related data structures. The options 
have the following meanings: 


-A show the address of any associated protocol 
control blocks; used for debugging 


—a show the state of all sockets; normally sockets 
used by server processes are not shown 


-i show the state of interfaces which have been 
auto-configured (interfaces statically configured 
into a system, but not located at boot time are 
not shown) 


—m show statistics recorded by the memory 
management routines (the network manages a 
“private share” of memory) 


—-n show network addresses as numbers (normally 
netstat interprets addresses and attempts to 
display them symbolically) 


—8 show per-protocol statistics 
-r show the routing tables 


The arguments system and core allow substitutes for the 
defaults /unix and /dev/kmem. 


If an interval is specified, netstat will continuously 
display the information regarding packet traffic on the 
configured network interfaces, pausing tnterval seconds 
before refreshing the screen. 


There are a number of display formats, depending on the 
information presented. The default display, for active 
sockets, shows the local and remote addresses, send and 
receive queue sizes (in bytes), protocol, and, optionally, 
the internal state of the protocol. 


Address formats are of the form ‘‘host.port’’ or 
“network.port’’ if a socket’s address specifies a network 
but no specific host address. When known, the host and 
network addresses are displayed symbolically according 
to the data bases /etc/hosts and /etc/networks, 
respectively. If a symbolic name for an address is 
unknown, or if the —n option is specified, the address is 
printed in the Internet ‘‘dot format”; refer to rhosts(4N) 
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for more information regarding this format. Unspecified, 
or ‘‘wildcard,”’ addresses and ports appear as ‘“‘*”’. 


The interface display provides a table of cumulative 
statistics regarding packets transferred, errors, and 
collisions. The network address (currently Internet 
specific) of the interface and the maximum transmission 
unit (‘‘mtu’’) are also displayed. 


The routing table display indicates the available routes 
and their status. Each route consists of a destination 
host or network and a gateway to use in forwarding 
packets. The “‘flags” field shows the state of the route 
“U” if “up’’), and whether the route is to a gateway 
“G”). Direct routes are created for each interface 
attached to the local host. The “‘refent”’ field gives the 
current number of active uses of the route. Connection- 
oriented protocols normally hold on to a single route for 
the duration of a connection, while connectionless 
protocols obtain a route then discard it. The use field 
provides a count of the number of packets sent using 
that route. The interface entry indicates the network 
interface utilized for the route. 


When netstat is invoked with an interval argument, it 
displays a running count of statistics related to network 
interfaces. This display consists of a column 
summarizing information for all interfaces and a column 
for the interface with the most traffic since the system 
was last rebooted. The first line of each screen of 
information contains a summary since the system was 
last rebooted. Subsequent lines of output show values 
accumulated over the preceding interval. 


SEE ALSO 
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hosts(4N), networks(4N), protocols(4N), services(4N). 
CTIX Internetworking Manual. 
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NAME 
newform — change the format of a text file 

SYNOPSIS 
newform {-s] [—itabspec] Ee tabspec] [-bn} [~en] 
{-pn] [-ani [—-f] [—echar] [—In] | files | 

DESCRIPTION 


Newform reads lines from the named files, or the 
standard input if no input file is named, and reproduces 
the lines on the standard output. Lines are reformatted 
in accordance with command line options in effect. 


Except for —s, command line options may appear in any 
order, may be repeated, and may be intermingled with 
the optional files. Command line options are processed 
in the order specified. This means that option sequences 
like ‘“‘“~el5 —160” will yield results different from ‘‘—160 
—el5”’. Options are applied to all files on the command 
line. 


—itabspec Input tab specification: expands tabs to 
spaces, according to the tab specifications 


given. Tabspec recognizes all tab 
specification forms described in tabs(1). In 
addition, tabspec may be —-, in which 


newform assumes that the tab specification is 
to be found in the first line read from the 
standard input (see fspec(4)). If no tabspec is 
given, tabspec defaults to —8. A tabspec of 
—O expects no tabs; if any are found, they are 
treated as —1. 


—otabspec Output tab specification: replaces spaces by 
tabs, according to the tab specifications 
given. The tab specifications are the same as 
for —itabspec. If no tabspec is given, tabspec 
defaults to ~8. A tabspec of —O means that 
no spaces will be converted to tabs on output. 


—In Set the effective line length to n characters. 
If n is not entered, —1 defaults to 72. The 
default line length without the —1 option is 80 
characters. Note that tabs and backspaces 
are considered to be one character (use —i to 
expand tabs to spaces). 


—bn Truncate n characters from the beginning of 
the line when the line length is greater than 
the effective line length (see —In). Default is 
to truncate the number of characters 
necessary to obtain the effective line length. 
The default value is used when —b with no n 
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is used. This option can be used to delete the 
sequence numbers from a COBOL program as 
follows: 

newform —ll —b7 file-name 


The —l1 must be used to set the effective line 
length shorter than any existing line in the 
file so that the —b option is activated. 


Same as —bn except that characters are 
truncated from the end of the line. 


Change the prefix/append character to k. 
Default character for k is a space. 


Prefix n characters (see —ck) to the beginning 
of a line when the line length is less than the 
effective line length. Default is to prefix the 
number of characters necessary to obtain the 
effective line length. 


Same as —pn except characters are appended 
to the end of a line. 


Write the tab specification format line on the 
standard output before any other lines are 
output. The tab specification format line 
which is printed will correspond to the format 
specified in the last —o option. If no —o 
option is specified, the line which is printed 
will contain the default specification of —8. 


Shears off leading characters on each line up 
to the first tab and places up to 8 of the 
sheared characters at the end of the line. If 
more than 8 characters (not counting the first 
bai are sheared, the eighth character is 
replaced by a * and any characters to the 
right of it are discarded. The first tab is 
always discarded. 


An error message and program exit will occur 
if this option is used on a file without a tab 
on each line. The characters sheared off are 
saved internally until all other options 
specified are applied to that line. The 
characters are then added at the end of the 
processed line. 


For example, to convert a file with leading 
digits, one or more tabs, and text on each 
line, to a file beginning with the text, all tabs 
after the first expanded to spaces, padded 
with spaces out to column 72 (or truncated to 
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column 72), and the leading digits placed 
starting at column 73, the command would 


DIAGNOSTICS 


be: 
newform -s -i ~—l —a -e file- 
name 
All diagnostics are fatal. 
usage: ... Newform was called with a 
bad option. 
not -8 format There was no tab on one line. 
can’t open file Self-explanatory. 
internal line too long A line exceeds 512 characters 


after being expanded in the 
internal work buffer. 


tabspec tn error A tab © specification _is 
incorrectly formatted, or 
specified tab stops are not 
ascending. 


tabspec indirection illegal A tabspec read from a file (or 
standard input) may not 
contain a tabspec referencing 
another file (or standard 
input). 


EXIT CODES 


O — normal execution 
1 — for any error 


SEE ALSO 


BUGS 


esplit(1), tabs(1), fspec(4). 


Newform normally only keeps track of physical 
characters; however, for the —i and —o options, newform 
will keep track of backspaces in order to line up tabs in 
the appropriate logical columns. 


Newform will not prompt the user if a tabspec is to be 
read from the standard input (by use of —i-— or —o—-). 


If the —f option is used, and the last —o option specified 
was —o-—-, and was preceded by either a —o—- or a 
—i—-—, the tab specification format line will be incorrect. 


NAME 
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newgrp — log in to a new group 


SYNOPSIS 


newgrp [-| [ group | 


DESCRIPTION 


FILES 


Newgrp changes a user’s group identification. The user 
remains logged in, and the current directory is 
unchanged, but calculations of access permissions to files 
are performed with respect to the new real and effective 
group IDs. The user is always given a new shell, 
replacing the current shell, by newgrp, regardless of 
whether it terminated successfully or due to an error 
condition (i.e., unknown group). 


Exported variables retain their values after invoking 
newgrp; however, all unexported variables are either 
reset to their default value or set to null. System 
variables (such as PS1, PS2, PATH, MAIL, and HOME), 
unless exported by the system or explicitly exported by 
the user, are reset to default values. For example, a user 
has a primary prompt string (PS1) other than $ 
(default) and has not exported PS1. After an invocation 
of newgrp , successful or not, their PS1 will now be set 
to the default prompt string $. Note that the shell 
command ezport (see sh(1)) is the method to export 
variables so that they retain their assigned value when 
invoking new shells. 


With no arguments, newgrp changes the group 
identification back to the group specified in the user’s 
password file entry. 


If the first argument to newgrp is a —, the environment 
is changed to what would be expected if the user 
actually logged in again. 


A password is demanded if the group has a password and 
the user does not, or if the group has a password and the 
user is not listed in /ete/group as being a member of 
that group. 


/etc/group system’s group file 
/etc/passwd system’s password file 


SEE ALSO 


BUGS 


esh(1), login(1), sh(1), group(4), passwd(4), environ(5). 


There is no convenient way to enter a password into 
fete] group. Use of group passwords is not encouraged, 
ecause, by their very nature, they encourage poor 
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security practices. Group passwords may disappear in 
the future. 
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NAME 
news — print news items 

SYNOPSIS 
news [| —a | [ —n | [| —8 | [ items | 

DESCRIPTION 
News is used to keep the user informed of current 
events. By convention, these events are described by 
files (ttems) in the directory /usr/news. 
When invoked without arguments, news prints the 
contents of all current files in /usr/news, most recent 
first, with each preceded by an appropriate header. 
News stores the “currency”? time as the modification 
date of a file named .mews_time in the user’s home 
directory (the identity of this directory is determined by 
the environment variable $HOME); only files more 
recent than this currency time are considered “current.” 
The —a option causes news to print all items, regardless 
of currency. In this case, the stored time is not changed. 
The —n option causes news to report the names of the 
current items without printing their contents, and 
without changing the stored time. 
The —s option causes news to report how many current 
items exist, without printing their names or contents, 
and without changing the stored time. It is useful to 
include such an invocation of news in one’s .profile file, 
or in the system’s /ete/profile. 
All other arguments are assumed to be specific news 
items that are to be printed. 
If a delete is typed during the printing of a news item, 
printing stops and the next item is started. Another 
delete within one second of the first causes the program 
to terminate. 

FILES 
/etc/profile 
/usr/news/* 
$HOME/.news_time 

SEE ALSO 
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profile(4), environ(5). 
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NAME 
nice — run a2 command at low priority 
SYNOPSIS 
nice { —increment | command [ arguments | 
DESCRIPTION 
Nice executes command with a lower CPU scheduling 
priority. If the increment argument (in the range 1-19) 
is given, it is used; if not, an increment of 10 is assumed. 
The super-user may run commands with priority higher 
than normal by using a negative increment, e.g., -—10. 
SEE ALSO 
nohup(1), nice(2). 
DIAGNOSTICS 
Nice returns the exit status of the subject command. 
BUGS 


An increment larger than 19 is equivalent to 19. 
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NAME 
nl — line numbering filter 


SYNOPSIS 
nl {—htype] {[—btype] [—ftype] te ae [-iincr} Pl 
(—Inum] [—ssep] [ ween (-nformat] |[—ddelim} fi 
DESCRIPTION 
NI reads lines from the named file or the standard input 
if no file is named and reproduces the lines on the 
standard output. Lines are numbered on the left in 
accordance with the command options in effect. 


NI views the text it reads in terms of logical pages. Line 
numbering is reset at the start of each logical page. A 
logical page consists of a header, a body, and a footer 
section. Empty sections are valid. Different line 
numbering options are independently available for 
header, body, and footer (e.g., no numbering of header 
and footer lines while numbering blank lines only in the 
body). 


The start of logical page sections are signaled by input 
lines containing nothing but the following delimiter 


character(s): 
Line contents Start of 
ANA: header 
es body 
Ns footer 


Unless optioned otherwise, ni assumes the text being 
read is in a single logical page body. 


Command options may appear in any order and may be 
intermingled with an optional file name. Only one file 
may be named. The options are: 


~—btype Specifies which logical page body lines are to 
be numbered. Recognized types and their 
meaning are: a, number all lines; t, number 
lines with printable text only; mn, no line 
numbering; pstring, number only lines that 
contain the regular expression specified in 
string. Default type for logical page body is t 
(text lines numbered). 


—htype Same as —btype except for header. Default 
type for logical page header is n (no lines 
numbered). 


—ftype Same as —btype except for footer. Default 
for logical page footer is nm (no_ lines 


Ss 


—p 
—vstart# 
—liner 


—ssep 


—wwidth 


—nformat 


—Inum 


—dzrzr 


EXAMPLE 
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numbered). 


Do not restart numbering at logical page 
delimiters. 


Start# is the initial value used to number 
logical page lines. Default is 1. 


Incr is the increment value used to number 
logical page lines. Default is 1. 


Sep is the character(s) used in separating the 
line number and the corresponding text line. 
Default sep is a tab. 


Width is the number of characters to be used 
for the line number. Default width is 6. 


Format is the line numbering format. 
Recognized values are: Im, left justified, 
leading zeroes suppressed; rn, right justified, 
leading zeroes supressed; rz, right justified, 
leading zeroes kept. Default format is rn 
(right justified). 

Num is the number of blank lines to be 
considered as one. For example, —12 results 
in only the second adjacent blank being 
numbered (if the appropriate —ha, —ba, 
and/or —fa option is set). Default is 1. 


The delimiter characters specifying the start 
of a logical page section may be changed 
from the default characters (\:) to two user- 
specified characters. If only one character is 
entered, the second character remains the 
default character (:). No space should appear 
between the ~—d and the delimiter characters. 
To enter a backslash, use two backslashes. 


The command: 


nl —v10 ~i10 —d!+ filel 


will number filel starting at line number 10 with an 
increment of ten. The logical page delimiters are !+-. 


SEE ALSO 
pr(1). 
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NAME 
nm — print name list of common object file 
SYNOPSIS 
nm [—o] [-x] [-h] [-v] [-n] [-e] [-f] [-u] [-V) 


[-T] file-names 


DESCRIPTION 


The nm command displays the symbol table of each 
common object file file-name. File-name may be a 
relocatable or absolute common object file; or it may be 
an archive of relocatable or absolute common object 
files. For each symbol, the following information will be 


printed: 
Name 
Value 


Class 
Type 


Size 


Line 


Section 


The name of the symbol. 


Its value expressed as an offset or an address 
depending on its storage class. 


Its storage class. 


Its type and derived type. If the symbol is an 
instance of a structure or of a union then the 
structure or union tag will be given following 
the type (e.g., struct-tag). If the symbol is an 
array, then the array dimensions will be given 
following the type (eg., eharinlim)): Note 
that the object file must have been compiled 
with the —g option of the ce(1) command for 
this information to appear. 


Its size in bytes, if available. Note that the 
object file must have been compiled with the 
—g option of the cc(1) command for this 
information to appear. 


The source line number at which it is defined, 
if available. Note that the object file must 
have been compiled with the —g option of the 
cc(1) command for this information to appear. 


For storage classes static and external, the 
object file section containing the symbol (e.g., 
text, data or bss). 


The output of nm may be controlled using the following 


options: 
-o 


—-x 


Print the value and size of a symbol in octal 
instead of decimal. 


Print the value and size of a symbol in 
hexadecimal instead of decimal. 
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—h Do not display the output header data. 

—v Sort external symbols by value before they are 
printed. 

—n Sort external symbols by name before they are 
printed. 

—e Print only external and static symbols. 

—-f Produce full output. Print redundant symbols 
(.text, .data and .bss), normally suppressed. 

—u Print undefined symbols only. 

-V Print the version of the nm command 


executing on the standard error output. 


-T By default, nm prints the entire name of the 
symbols listed. Since object files can have 
symbols names with an arbitrary number of 
characters, a name that is longer than the 
width of the column set aside for names will 
overflow its column, forcing every column 
after the name to be misaligned. The —T 
option causes nm to truncate every name 
which would otherwise overflow its column 
and place an asterisk as the last character in 
the displayed name to mark it as truncated. 


Options may be used in any order, either singly or in 
combination, and may appear anywhere in the command 
line. Therefore, both nm name —e —v and nm —ve 
name print the static and external symbols in name, 
with external symbols sorted by value. 


FILES 
/usr/tmp/nm?????? 

CAVEATS 
When all the symbols are printed, they must be printed 
in the order they appear in the symbol table in order to 
preserve scoping information. Therefore, the —v and —n 
options should be used only in conjunction with the —e 
option. 

SEE ALSO 
as(1), cc(1), Id(1), a-out(4), ar(4). 

DIAGNOSTICS 


“nm: name: cannot open” 
if name cannot be read. 


“nm: name: bad magic” 
if name is not an appropriate common object 
file. 
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‘nm: name: no symbols” 
if the symbols have been stripped from name. 
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NAME 

nohup — run a command immune to hangups and quits 
SYNOPSIS 

nohup command [| arguments | 
DESCRIPTION 


Nohup executes command with hangups and quits 
ignored. If output is not re-directed by the user, both 
standard output and standard error are sent to 
nohup.out. If nohup.out is not writable in the current 
directory, output is redirected to SHOME/nohup.out. 


EXAMPLE 
It is frequently desirable to apply nohup to pipelines or 
lists of commands. This can be done only by placing 
pipelines and command lists in a single file, called a shell 
procedure. One can then issue: 


nohup sh file 


and the nohup applies to everything in file. If the shell 
procedure file is to be executed often, then the need to 
type sh can be eliminated by giving file execute 
permission. Add an ampersand and the contents of file 
are run in the background with interrupts also ignored 
(see sh(1)): 


nohup file & 
An example of what the contents of file could be is: 


tbl ofile | eqn | nroff > nfile 
SEE ALSO 
chmod(1), nice(1), sh(1), signal(2). 


WARNINGS 
nohup command1; command2 
nohup applies only to command 


nohup (command1; command2) 
is syntactically incorrect. 


Be careful of where standard error is redirected. The 
following command may put error messages on tape, 
making it unreadable: 


nohup cpio —o <list >/dev/rmt/1m& 
while 
nohup cpio —o <list >/dev/rmt/1m 2>errors& 


puts the error messages into file errors. 


She 
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NAME 

nroff — format text 
SYNOPSIS 

nroff [ options | | files | 
DESCRIPTION 


5/86 


Nroff formats text contained in files (standard input by 
default) for printing on typewriter-like devices and line 


printers. 


If no input file is given, or if the argument — is 
encountered, nroff reads from the standard input file. 
The options, which may appear in any order, but must 
appear before the files, are: 


—oltst 


—-nN 
—sN 


~raN 


—-mname 


—cname 


—kname 


—Tname 


Print only pages whose page numbers appear 
in the itst of numbers and ranges, separated 
by commas. A range N—M means pages N 
through M; an initial —N means from the 
beginning to page N; and a final N— means 
from N to the end. (See BUGS below.) 
Number first generated page N. 
Stop every N pages. Nroff will halt after 
every N pages (default N=1) to allow paper 
loading or changing, and will resume upon 
receipt of a line-feed or new-line (new-lines do 
not work in pipelines, e.g., with mm/(1)). This 
option does not work if the output of nroff is 
piped through col(1). When nroff halts 
between pages, an ASCII BEL is sent to the 
terminal. 
Set register a (which must have a one- 
character name) to N. 
Read standard input after files are exhausted. 
Invoke the simultaneous input-output mode of 
the .rd request. 
Print only messages generated by .tm 
pores message) requests. 

repend to the input files the non-compacted 
(ASCII text) macro file 
pss BE ene) ae name. 

repend to the input files the compacted 
macro files 
/usr/lib/macros/cmp.(nt|.[dt].name and 
/usr/lib/macros/ucmp.(nt|.name. 
Compact the macros used in this invocation of 
nroff, placing the output in files [dt].name in 
the current directory 
Prepare output for specified terminal. Known 
names are 87 for the (default) TELETYPE 
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Model 37 terminal, tn300 for the GE 
TermiNet 300 (or any terminal without half- 
line capability), 300s for the DASI 300s, 300 
for the DASI 300, 450 for the DASI 450, Ip for 
a (generic) ASCII line printer, 382 for the 
DTC-382, 4000A for the Trendata 4000A, 
832 for the Anderson Jacobson 832, X for a 
generic) EBCDIC printer, and 2631 for the 
ewlett Packard 2631 line printer. 


—e Produce equally-spaced words in adjusted 
lines, using the full resolution of the particular 
terminal. 

-h Use output tabs during horizontal spacing to 


speed output and reduce output character 
count. Tab settings are assumed to be every 
8 nominal character widths. 

—un Set the emboldening factor (number of 
character overstrikes) for the third font 
position (bold) to n, or to zero if n is missing. 


FILES 
/usr/lib/suftab suffix hyphenation tables 
/tmp/ta$# temporary file 
/usr/lib/tmac/tmac.* standard macro files and pointers 
/usr/lib/macros/* standard macro files 
/usr/lib/term/* terminal driving tables for nroff 

SEE ALSO 
col(1), cw(1), eqn(1), greek(1), mm/(1), tbl(1), troff(1), 
mm(5). 

BUGS 


Nroff believes in Eastern Standard Time; as a result, 
depending on the time of the year and on your local time 
zone, the date that nroff generates may be off by one 
day from your idea of what the date is. 

When nroff is used with the —oltst option inside a 
pipeline it may cause a harmless “broken pipe”’ 
diagnostic if the last page of the document is not 
specified in list. 
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NAME 

od — octal dump 
SYNOPSIS 

od [ —bedosxf | | file |] [ [ + Joffset{ . ][ b ] ] 
DESCRIPTION 


Od dumps file in one or more formats as selected by the 
first argument. If the first argument is missing, —o is 
default. The meanings of the format options are: 


—-b ss Interpret bytes in octal. 


-c Interpret bytes in ASCII. Certain non-graphic 
characters appear as C_ escapes: null=\0, 
backspace=\b, form-feed=\f, new-line=\n, 
return—\r, tab=\t; others appear as 3-digit octal 
numbers. 


-d___ Interpret words in unsigned decimal. 

-o Interpret words in octal. 

-s __ Interpret 16-bit words in signed decimal. 
-x _ Interpret words in hexadecimal. 


-f Interpret bytes in hexadecimal with ASCII listing 
at side. 


The file argument specifies which file is to be dumped. 
If no file argument is specified, the standard input is 
used. 


The offset argument specifies the offset in the file where 
dumping is to commence. This argument is normally 
interpreted as octal bytes. If . is appended, the offset is 
interpreted in decimal. If b is appended, the offset is 
interpreted in blocks of 512 bytes. If the file argument is 
omitted, the offset argument must be preceded by +. 


Dumping continues until end-of-file. 


SEE ALSO 


dump(1), hd(1). 
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NAME 

pack, peat, unpack — compress and expand files 
SYNOPSIS 

pack [| —]| {| -f]| name... 

peat name ... 


unpack name ... 


DESCRIPTION 


Pack attempts to store the specified files in a compressed 
form. Wherever possible (and useful), each input file 
name is replaced by a packed file name.z with the same 
access modes, access and modified dates, and owner as 
those of name. The -f option will force packing of 
name. This is useful for causing an entire directory to 
be packed even if some of the files will not benefit. If 
pack is successful, name will be removed. Packed files 
can be restored to their original form using unpack or 
peat. 


Pack uses Huffman (minimum redundancy) codes on a 
byte-by-byte basis. If the — argument is used, an 
internal flag is set that causes the number of times each 
byte is used, its relative frequency, and the code for the 
byte to be printed on the standard output. Additional 
occurrences of — in place of name will cause the internal 
flag to be set and reset. 


The amount of compression obtained depends on the size 
of the input file and the character frequency distribution. 
Because a decoding tree forms the first part of each .z 
file, it is usually not worthwhile to pack files smaller 
than three blocks, unless the character frequency 
distribution is very skewed, which may occur with 
printer plots or pictures. 


Typically, text files are reduced to 60-75% of their 
original size. Load modules, which use a larger character 
set and have a more uniform distribution of characters, 
show little compression, the packed versions being about 
90% of the original size. 


Pack returns a value that is the number of files that it 
failed to compress. 


No packing will occur if: 


the file appears to be already packed; 

the file name has more than 12 characters; 

the file has links; 

the file is a directory; 

the file cannot be opened; 

no disk storage blocks will be saved by packing; 
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a file called name.sz already exists; 
the .z file cannot be created; 
an I/O error occurred during processing. 


The last segment of the file name must contain no more 
than 12 characters to allow space for the appended .z 
extension. Directories cannot be compressed. 


Peat does for packed files what cat(1) does for ordinary 
files, except that peat can not be used as a filter. The 
specified files are unpacked and written to the standard 
output. Thus to view a packed file named name.z use: 


pcat name.z 
or just: 

pcat name 
To make an unpacked copy, say nnn, of a packed file 
named name.x (without destroying name.z) use the 
command: 


peat name >nnn 


Peat returns the number of files it was unable to 
unpack. Failure may occur if: 


the file name (exclusive of the .z) has more than 
12 characters; 

the file cannot be opened; 

mee does not appear to be the output of 
pack, 


Unpack expands files created by pack. For each file 
name specified in the command, a search is made for a 
file called name.z (or just name, if name ends in .z). If 
this file appears to be a packed file, it is replaced by its 
expanded version. The new file has the .z suffix stripped 
from its name, and has the same access modes, access 
and modification dates, and owner as those of the 
packed file. 


Unpack returns a value that is the number of files it was 
unable to unpack. Failure may occur for the same 
reasons that it may in peat, as well as for the following: 


a file with the “unpacked” name already exists; 
if the unpacked file cannot be created. 


SEE ALSO 


cat(1). 


NAME 


PASSWD (1) 


passwd — change login password 


SYNOPSIS 


passwd [ name | 


DESCRIPTION 


This command changes or installs a password associated 
with the login name. 


Ordinary users may change only the password which 
corresponds to their login name. 


Passwd prompts ordinary users for their old password, if 
any. It then prompts for the new password twice. The 
first time the new password is entered passwd checks to 
see if the old password has ‘‘aged”’ sufficiently. If 
“aging” is insufficient the new password is rejected and 
passwd terminates; see passwd(4). 


Assuming ‘‘aging”’ is sufficient, a check is made to insure 
that the new password meets construction requirements. 
When the new password is entered a second time the two 
copies of the new password are compared. If the two 
copies are not identical the cycle of prompting for the 
new password is repeated for at most two more times. 


Passwords must be constructed to meet the following 
requirements: 


Each password must have at least six characters. 
Only the first eight characters are significant. 


Each password must contain at least two 
alphabetic characters and at least one numeric 
or special character. In this case, “alphabetic’’ 
means upper and lower case letters. 


Each password must differ from the user’s login 
name and any reverse or circular shift of that 
login name. For comparison purposes, an upper 
case letter and its corresponding lower case letter 
are equivalent. 


New passwords must differ from the old by at 
least three characters. For comparison purposes, 
an upper case letter and its corresponding lower 
case letter are equivalent. 


One whose effective user ID is zero is called a super-user; 
see td(1), and su(1). Super-users may change any 
password; hence, passwd does not prompt super-users for 
the old password. Super-users are not forced to comply 
with password aging and password construction 
requirements. A super-user can create a null password 
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by entering a carriage return in response to the prompt 
for a new password. 


FILES 
/etc/passwd — password file 
/etc/opasswd -— password file before password was 
changed 

SEE ALSO 


login(1), id(1), su(1), passwd(4). 
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NAME 
paste — merge same lines of several files or subsequent 
lines of one file 


SYNOPSIS 
paste filei file2 ... 
paste —d list filel file2 ... 
paste —s [~d list] filel file2 ... 


DESCRIPTION 

In the first two forms, paste concatenates corresponding 
lines of the given input files file1, file2, etc. It treats 
each file as a column or columns of a table and pastes 
them together horizontally (parallel merging). If you 
will, it is the counterpart of cat(1) which concatenates 
vertically, i.e., one file after the other. In the last form 
above, paste replaces the function of an older command 
with the same name by combining subsequent lines of 
the input file (serial merging). In all cases, lines are 
glued together with the tab character, or with characters 
from an optionally specified list. Output is to the 
standard output, so it can be used as the start of a pipe, 
or as a filter, if — is used in place of a file name. 


The meanings of the options are: 


~d Without this option, the new-line characters of 
each but the last file (or last line in case of the 
~s option) are replaced by a tab character. This 
option allows replacing the tab character by one 
or more alternate characters (see below). 


list One or more characters immediately following 
~d replace the default tab as the line 
concatenation character. The list is used 
circularly, i.e., when exhausted, it is reused. In 
parallel merging (i-e., no —s option), the lines 
from the last file are always terminated with a 
new-line character, not from the list. The list 
may contain the special escape sequences: \n 
new-line), \t (tab), \\ (backslash), and \O 
empty string, not a null character). Quoting 
may be necessary, if characters have special 
meaning to the shell (e.g., to get one backslash, 
use -d"\\\\" ). 

-8 Merge subsequent lines rather than one from 
each input file. Use tab for concatenation, 
unless a list is specified with -—d_ option. 
Regardless of the list, the very last character of 
the file is forced to be a new-line. 
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_ May be used in place of any file name, to read a 
line from the standard input. (There is no 


prompting). 
EXAMPLES 
Is | paste ~d”” - list directory in one 
column 
Is | paste ~ - - - list directory in four 
columns 
paste -s —d”\t\n” file combine pairs of lines 
into lines 
SEE ALSO 
grep(1), cut(1), pr(1). 
DIAGNOSTICS 


line too long 
Output lines are restricted to 511 characters. 


too many files 
Except for —s option, no more than 12 input 
files may be specified. 


NAME 


PATH(1) 


path — locate executable file for command 


SYNOPSIS 


path [| -options | command 


DESCRIPTION 


Path is a quick way to discover which executable file is 
behind a shell command. It searches each directory 
mentioned in your PATH environment variable until it 
finds an executable file called command. 


Any options specified are passed to Is(1). 


WARNING 


The shell (sh(1)) hashes the location of certain 
commands. Therefore, path and type (shell built-in) 
may give different results. 


SEE ALSO 


Is(1). 
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NAME 
pg — file perusal filter for soft-copy terminals 


SYNOPSIS 
g [-number] [—p string] [-cefns] [+linenumber] 
+/pattern/] {files... 


DESCRIPTION 

The pg command is a filter which allows the examination 
of files one screenful at a time on a soft-copy terminal. 
(The file name ~ and/or NULL arguments indicate that 
pg should read from the standard input.) Each screenful 
is followed by a prompt. If the user types a carriage 
return, another page is displayed; other possibilities are 
enumerated below. 


This command is different from previous paginators in 
that it allows you to back up and review something that 
has already passed. The method for doing this is 
explained below. 


In order to determine terminal attributes, pg scans the 
terminfo(4) data base for the terminal type specified by 
the environment variable TERM. If TERM is not 
defined, the terminal type dumb is assumed. 


The command line options are: 


~number 
An integer specifying the size . lines) of the 
window that pg is to use instead of the default. 
(On a terminal containing 24 lines, the default 
window size is 23). 


—p string 
Causes pg to use string as the prompt. If the 
prompt string contains a ‘%d”, the first 
occurrence of ‘‘%d” in the prompt will be 
replaced by the current page number when the 
prompt is issued. The default prompt string is 
66,99 

-¢ Home the cursor and clear the screen before 
displaying each page. This option is ignored if 
clear_screen is not defined for this terminal 
type in the terminfo(4) data base. 


~e Causes pg not to pause at the end of each file. 


-f Normally, pg splits lines longer than the screen 
width, but some sequences of characters in the 
text being displayed (e.g., escape sequences for 
underlining) generate undesirable results. The 
~f option inhibits pg from splitting lines. 
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—n Normally, commands must be terminated by a 
<newline > character. This option causes an 
automatic end of command as soon as a 
command letter is entered. 


-8 Causes pg to print all messages and prompts in 
standout mode (usually inverse video). 


+linenumber 
Start up at linenumber. 


+/ pattern / 
Start up at the first line containing the regular 


expression pattern. 


The responses that may be typed when pg pauses can be 
divided into three categories: those causing further 
perusal, those that search, and those that modify the 
perusal environment. 


Commands which cause further perusal normally take a 
preceding address, an optionally signed number 
indicating the point from which further text should be 
displayed. This address is interpreted in either pages or 
lines depending on the command. A signed address 
specifies a point relative to the current page or line, and 
an unsigned address specifies an address relative to the 
beginning of the file. Each command has a default 
address that is used if none is provided. 

The perusal commands and their defaults are as follows: 

(+1)<newline > or <blank> 
This causes one page to be displayed. The 
address is specified in pages. 

(+1)1 With a relative address this causes pg to 
simulate scrolling the screen, forward or 
backward, the number of lines specified. With 
an absolute address this command prints a 
screenful beginning at the specified line. 

(+1) dor “D 
Simulates scrolling half a screen forward or 
backward. 


The following perusal commands take no address. 


.or “L Typing a single period causes the current page of 
text to be redisplayed. 

$ Displays the last windowful in the file. Use with 
caution when the input is a pipe. 

The following commands are available for searching for 


text patterns in the text. The regular expressions 
described in ed(1) are available. They must always be 
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terminated by a <newline>, even if the —n option is 
specified. 


t/ pattern / 
Search forward for the ‘th (default #==1) 
occurrence of pattern. Searching begins 


immediately after the current page and 
continues to the end of the current file, without 
wrap-around. 


t“pattern* 


t?pattern? 
Search backwards for the ith (default ¢==1) 
occurrence of pattern. Searching begins 


immediately before the current page and 
continues to the beginning of the current file, 
without wrap-around. The * notation is useful 
for Adds 100 terminals which will not properly 
handle the ?. 


After searching, pg will normally display the line found 
at the top of the screen. This can be modified by 
appending m or b to the search command to leave the 
line found in the middle or at the bottom of the window 
from now on. The suffix t can be used to restore the 
original situation. 


The user of pg can modify the environment of perusal 
with the following commands: 


in Begin perusing the th next file in the command 
line. The tis an unsigned number, default value 
is 1. 

ip Begin perusing the tth previous file in the 
command line. # is an unsigned number, default 
is 1. 

tw Display another window of text. If ¢ is present, 
set the window size to ?. 

s filename 


Save the input in the named file. Only the 
current file being perused is saved. The white 
space between the s and filename is optional. 
This command must always be terminated by a 
<newline >, even if the -n option is specified. 


h Help by displaying an abbreviated summary of 
available commands. 


qorQ Quit pg. 
!command 
Command is passed to the shell, whose name is 


SB 
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taken from the SHELL environment variable. If 
this is not available, the default shell is used. 
This command must always be terminated by a 
<newline >, even if the —n option is specified. 


At any time when output is being sent to the terminal, 
the user can hit the quit key (normally control-\) or the 
interrupt (break) key. This causes pg to stop sending 
output, and display the prompt. The user may then 
enter one of the above commands in the normal manner. 
Unfortunately, some output is lost when this is done, due 
to the fact that any characters waiting in the terminal’s 
output queue are flushed when the quit signal occurs. 


If the standard output is not a terminal, then pg acts 
just like cat(1), except that a header is printed before 
each file (if there is more than one). 


EXAMPLE 


A sample usage of pg in reading system news would be 
news | pg -p "(Page %d):” 


NOTES 
While waiting for terminal input, pg responds to 
BREAK, DEL, and ~* by terminating execution. 
Between prompts, however, these signals interrupt pg’s 
current task and place the user in prompt mode. These 
should be used with caution when input is being read 
from a pipe, since an interrupt is likely to terminate the 
other commands in the pipeline. 

Users of Berkeley’s more will find that the z and f 
commands are available, and that the terminal /, *, or ? 
may be omitted from the searching commands. 

FILES 
/usr/lib/terminfo/* 

Terminal information data base 
/tmp/pg* tees 
Temporary file when input is from a pipe 

SEE ALSO 
crypt(1), ed(1), grep(1), more(1), terminfo(4). 

BUGS 


If terminal tabs are not set every eight positions, 
undesirable results may occur. 


When using pg as a filter with another command that 
changes the terminal ue options (e.g., crypt(l)), 
terminal settings may not be restored correctly. 
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NAME 
pr — print files 
SYNOPSIS 
pr [| options | | files | 
DESCRIPTION 
Pr prints the named files on the standard output. If file 
is —, or if no files are specified, the standard input is 


assumed. By default, the listing is separated into pages, 
each headed by the page number, a date and time, and 
the name of the file. a 


By default, columns are of equal width, separated by at 
least one space; lines which do not fit are truncated. If 
the -—s option is used, lines are not truncated and 
columns are separated by the separation character. 


If the standard output is associated with a terminal, 
error messages are withheld until pr has completed 
printing. 


The below options may appear singly or be combined in 
any order: 
+k Begin printing with page k (default is 1). 


—k Produce k-column output (default is 1). The 
options —e and —i are assumed for multi-column 
output. 


—a Print multi-column output across the page. 


~m Merge and print all files simultaneously, one per 
column (overrides the —k, and ~a options). 


~d Double-space the output. 


~eck Expand input tabs to character positions k+1, 
2*k+1, 3*k+1, etc. If k is O or is omitted, 
default tab settings at every eighth position are 
assumed. Tab characters in the input are 
expanded into the appropriate number of spaces. 
If ¢ (any non-digit character) is given, it is 
treated as the input tab character (default for ¢ 
is the tab character). 


-ick In output, replace white space wherever possible 
by inserting tabs to character positions k+1, 
2*k+1, 3*k+1, etc. If & is O or is omitted, 
default tab settings at every eighth position are 
assumed. If ¢ (any non-digit character) is given, 
it is treated as the output tab character (default 
for ¢ is the tab character). 


—nek 


—ok 


-lk 


-p 


-f 


—-Fr 


—t 


EXAMPLES 
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Provide k-digit line numbering (default for k is 
5). The number occupies the first k+1 character 
positions of each column of normal output or 
each line of —m output. If c (any non-digit 
character) is given, it is appended to the line 
number to separate it from whatever follows 
(default for ¢ is a tab). 


Set the width of a line to k character positions 
(default is 72 for equal-width multi-column 
output, no limit otherwise). 


Offset each line by & character positions (default 
is 0). The number of character positions per line 
is the sum of the width and offset. 


Set the length of a page to k lines (default is 66). 


Use the next argument as the header to be 
printed instead of the file name. 


Pause before beginning each page if the output 
is directed to a terminal (pr will ring the bell at 
the terminal and wait for a carriage return). 


Use form-feed character for new pages (default is 
to use a sequence of line-feeds). Pause before 
beginning the first page if the standard output is 
associated with a terminal. 


Print no diagnostic reports on failure to open 
files. 


Print neither the five-line identifying header nor 
the five-line trailer normally supplied for each 
page. Quit printing after the last line of each 
file without spacing to the end of the page. 


Separate columns by the single character c 
instead of by the appropriate number of spaces 
(default for ¢ is a tab). 


Print filel and file2 as a double-spaced, three-column 
listing headed by “‘file list”: 


pr —3dh "file list” filel file2 


Write filel on file2, expanding tabs to columns 10, 19, 


28, 37,...: 
pr —e9 -t <filel >file2 
FILES 
/dev/tty* to suspend messages 
SEE ALSO 
cat(1). 
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NAME 
prof — display profile data 


SYNOPSIS 
rof [—tean] [ox] [-g] [-s] (-h] [-s] [-m mdata] 

prog] 

DESCRIPTION 
Prof interprets a profile file produced by the 
monitor(3C) function. The symbol table in the object 
file prog (a.out by default) is read and correlated with a 
profile file (mon.out by default). For each external text 
symbol the percentage of time spent executing between 
the address of that symbol and the address of the next is 
printed, together with the number of times that function 


was called and the average number of milliseconds per 
call, 


The mutually exclusive options t, c, a, and n determine 
the type of sorting of the output lines: 


—t Sort by decreasing percentage of total time 
(default). 

—¢ Sort by decreasing number of calls. 

—a Sort by increasing symbol address. 

-n Sort lexically by symbol name. 


The mutually exclusive options o and x specify the 
printing of the address of each symbol monitored: 


-o Print each symbol address (in octal) along with 
the symbol name. 


-x Print each symbol address (in hexadecimal) 
along with the symbol name. 


The following options may be used in any combination: 
-g Include non-global symbols (static functions). 


2 Include all symbols in the profile range (see 
monttor(3C)), even if associated with zero 
number of calls and zero time. 


—h Suppress the heading normally printed on the 
report. (This is useful if the report is to be 
processed further.) 


-8 Print a summary of several of the monitoring 
parameters and statistics on the standard error 
output. 

~m mdata 


Use file mdata instead of mon.out as the input 
profile file. 


FILES 


PROF (1) 


A program creates a profile file if it has been loaded with 
the —p option of ec(1). This option to the ce command 
arranges for calls to monttor(3C) at the beginning and 
end of execution. It is the call to monitor at the end of 
execution that causes a profile file to be written. The 
number of calls to a function is tallied if the —p option 
was used when the file containing the function was 
compiled. 


The name of the file created by a profiled program is 
controlled by the environment variable PROFDIR. If 
PROFDIR does not exist, ‘“mon.out”’ is produced in the 
directory current when the program terminates. If 
PROFDIR = string, “string/pid.progname”’ is produced, 
where progname consists of argv|0| with any path prefix 
removed, and ptd is the program’s process id. 

PROFDIR = nothing, no profiling output is produced. 


A single function may be split into subfunctions for 
profiling by means of the MARK macro (see prof(5)). 


mon.out for profile 
a.out for namelist 


SEE ALSO 


ce(1), exit(2), profil(2), monitor(3C), prof(5). 


WARNING 


BUGS 


The times reported in successive identical runs may show 
variances of 20% or more, because of varying cache-hit 
ratios due to sharing of the cache with other processes. 
Even if a program seems to be the only one using the 
machine, hidden background or asynchronous processes 
may blur the data. In rare cases, the clock ticks 
initiating recording of the program counter may “beat’”’ 
with loops in a_ program, grossly distorting 
measurements. 


Call counts are always recorded precisely, however. 


Only programs that call eztt(2) or return from main will 
cause a profile file to be produced, unless a final call to 
monitor is explicitly coded. 


The use of the ~p option cc(1) to invoke profiling 
imposes a limit of 600 (300 on the PDP-11) functions that 
may have call counters established during program 
execution. For more counters you must call monitor(3C) 
directly. If this limit is exceeded, other data will be 
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overwritten and the mon.out file will be corrupted. 
The number of call counters used will be reported 
automatically by the prof command whenever the 
number exceeds 5/6 of the maximum. 


NAME 


PROFILER (1M) 


prfld, prfstat, prfdc, prfsnap, prfpr — operating system 
profiler 


SYNOPSIS 


/ete/prfld [{ namelist | 

/etc/prfstat on 

/ete/prfstat off 

/ete/prfdc file { period [ off_hour | | 
/etc/prfsnap file 

/etc/prfpr file | cutoff | namelist | | 


DESCRIPTION 


Prfld, prfstat, prfde, prfanap, and prfpr form a system of 
programs to facilitate an activity study of the CTIX 
operating system. <A kernel configured with kernel 
profiling must be used. 


Prfld is used to initialize the recording mechanism in the 
system. It generates a table containing the starting 
address of each system subroutine as extracted from 
nameltst. 


Prfstat is used to enable or disable the sampling 
mechanism. Profiler overhead is less than 1% as 
calculated for 500 text addresses. Prfstat will also reveal 
the number of text addresses being measured. 


Prfde and prfsnap perform the data collection function 
of the profiler by copying the current value of all the 
text address counters to a file where the data can be 
analyzed. Prfde will store the counters into file every 
period minutes and will turn off at off_hour (valid values 
for off_hour are 0-24). Prfsnap collects data at the 
time of invocation only, appending the counter values to 
file. 

Prfpr formats the data collected by prfde or prfsnap. 
Each text address is converted to the nearest text symbol 
(as found in nemelist) and is printed if the percent 
activity for that range is greater than cutoff. 


FILES 
/dev/prf interface to profile data and _ text 
addresses 
/unix default for namelist file 

SEE ALSO 


prf(7). 
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NAME 
prs — print an SCCS file 


SYNOPSIS 
rs [-didersepeel| (-r[SID]] {-e] (-I] [—c[date-time]] 

Pal iles 

DESCRIPTION 
Pres prints, on the standard output, parts or all of an 
SCCS file (see sccsftle(4)) in a user-supplied format. If a 
directory is named, prs behaves as though each file in 
the directory were specified as a named file, except that 
non-SCCS files (last component of the path name does 
not begin with s.), and unreadable files are silently 
ignored. If a name of — is given, the standard input is 
read; each line of the standard input is taken to be the 
name of an SCCS file or directory to be processed; non- 
SCCS files and unreadable files are silently ignored. 


Arguments to prs, which may appear in any order, 
consist of keyletter arguments, and file names. 


All the described keyletter arguments apply 
independently to each named file: 


~d[dataspec| Used to specify the output data 
specification. The dataspec is a 
string consisting of SCCS file data 
keywords (see DATA KEYWORDS) 
interspersed with optional user 
supplied text. 


—r[SID} Used to specify the SCCS 
IDentification (SID) string of a 
delta for which information is 
desired. If no SID is specified, the 
SID of the most recently created 
delta is assumed. -e and -] 
keyletters. The format for the 
date is: mm/dd/yy [hh:mm:ss]. 


-e Requests information for all deltas 
created earlier than and including 
the delta designated via the —r 
keyletter or the date given by the 
—c option. 

-l Requests information for all deltas 
created later than and including 
the delta designated via the —r 
keyletter or the date given by the 
—c option. 
[—e[cutoff]] Cutoff date-time, in 


-l- 
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the form: 


YY(MM[DD[HH[MM{ss}}}}] 


—e[date-time] | Units omitted from the date-time 
default to their maximum possible 
values; that is, -—c7502 is 
equivalent to ~—c750228235959. 
Any number of non-numeric 
characters may separate the 
various 2-digit pieces of the cutoff 
date in the form: 


"097 /2/2 9:22:25". 


~a Requests printing of information 
for both removed, i.e., delta type 
= R, (see rmdef(1)) and existing, 
i.e., delta type = D, deltas. If 
the —a keyletter is not specified, 
information for existing deltas 
only is provided. 


DATA KEYWORDS 
Data keywords specify which parts of an SCCS file are to 
be retrieved and output. All parts of an SCCS file (see 
sccafile(4)) have an associated data keyword. There is 
no limit on the number of times a data keyword may 
appear in a dataspec. 


The information printed by pre consists of: (1) the user- 
supplied text; and () appropriate values (extracted from 
the SCCS file) substituted for the recognized data 
keywords in the order of appearance in the dataspec. 
The format of a data keyword value is either Simple (S), 
in which keyword substitution is direct, or Multt-dine 
(M), in which keyword substitution is followed by a 
carriage return. 


User-supplied text is any text other than recognized data 
keywords. 


A tab is specified by \t and carriage return/new-line is 
specified by \n. The default data keywords are: 


”:Dt:\t:DL:\nMRs:\n:MR:COMMENTS:\n:C:” 
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TABLE 1. SCCS Files Data Keywords 


Keyword Data Item 


:Dt: 


:DL: 


‘Li: 
Ld: 


Delta information 
Delta line statistics 
Lines inserted by Delta 
Lines deleted by Delta 
Lines unchanged by Delta 
Delta type 

SCCS D string (SID) 
Release number 

Level number 

Branch number 
Sequence number 

Date Delta created 
Year Delta created 
Month Delta created 
Day Delta created 
Time Delta created 
Hour Delta created 
Minutes Delta created 
Seconds Delta created 


Programmer who created Delta 


Delta sequence number 
Predecessor Delta seq-no. 


Seq-no. of deltas incl., excl., ignored 


Deltas included (seq #) 
Deltas excluded (seq #) 
Deltas ignored (seq #) 
MR numbers for delta 
Comments for delta 

User names 

Flag list 

Module type flag 

MR validation flag 

MR validation pgm name 
Keyword error /warning flag 
Keyword validation string 
Branch flag 

Joint edit flag 

Locked releases 

User defined keyword 
Module name 

Floor boundary 

Ceiling boundary 

Default SID 

Null delta flag 

File descriptive text 
Body 

Gotten body 

A form of what(1) string 


File Section 
Delta Table 


a 
n” 
Ca 
” 
” 
” 
n” 
” 
” 
wn” 
" 
” 
” 
” 
Ue 
” 
” 
” 
” 
” 
” 
" 
” 
n” 
” 
” 


” 


User Names 
Flags 


2 2 ®_V.BweR eset erEeE ss 


Comments 
Body 


N/A 


Value 

See below* 

‘Li:/:Ld:/:Lu: 
nnnnn 
nnnnn 
nnnnn 
DorR 

*ResLi.2Br.38: 
nnonn 
noon 
nnan 
onnn 


:‘Dy:/:Dm:/:Dd: 


nn 
mn 
nn 
‘Th::Tm:::Ts: 
nn 
nn 
nn 
logname 
nnn 
nnn 


:Dn:/:Dx:/:Dg: 


‘DS: :DS:... 
‘DS: :DS:... 
‘DS: :DS:... 
text 
text 
text 
text 
text 
yee or no 
text 
yes or no 
text 
yee or no 
yes or no 
‘R:... 
text 
text 
-R: 
:R: 
tk: 
yea or no 
text 
text 
text 
ZuMi\ til: 


Format 


HLL LNNNNUNNNNNNHKHNUNZTTTZTNANHNURNHNUNNAANNNNNNNNNANNNANAN 
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:A: A form of what(1) string N/A oo :Z¥::M: IZ: S 
:Z: — what(1) string delimiter N/A Q(#) s 
‘F: SCCS file name N/A text s 
‘PN: SCCS file path name N/A text s 
* Dt: = :DT: :L: :D: :T: :P: :DS: :DP: 
EXAMPLES 
prs —d”Users and/or user IDs for :F: are:\n:UN:” 
s.file 
may produce on the standard output: 
Users and/or user IDs for s.file are: 
XyZ 
131 
abc 
prs —d” Newest delta for pgm :M:: :I: Created :D: 
By :P:” ~rs.file 
may produce on the standard output: 
Newest delta for pgm main.c: 3.7 Created 
77/12/1 By cas 
As a spectal case: 
prs s.file 
may produce on the standard output: 
D 1.1 77/12/1 00:00:00 cas 1 000000/00000 /00000 
MRs: 
b178-12345 
bl79-54321 
COMMENTS: 
this is the comment line for s.file initial delta 
for each delta table entry of the “D” type. The only 
keyletter argument allowed to be used with the special 
case is the —a keyletter. 
FILES 
/tmp/pr????? 
SEE ALSO 
admin(1), delta(1), get(1), help(1), scesfile(4). 
CTIX Programmer’s Guide, Section 9. 
DIAGNOSTICS 


Use help(1) for explanations. 
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NAME 

ps — report process status 
SYNOPSIS 

ps { options | 
DESCRIPTION 


Ps prints certain information about active processes. 
Without options, information is printed about processes 
associated with the current terminal, or under window 
management, processes associated with the current 
window. The output consists of a short listing 
containing only the process ID, terminal identifier, 
cumulative execution time, and the command name. 
Otherwise, the information that is displayed is controlled 
by the selection of options. 


Options using lists as arguments can have the list 
specified in one of two forms: a list of identifiers 
separated from one another by a comma, or a list of 
identifiers enclosed in double quotes and separated from 
one another by a comma and/or one or more spaces. 


The options are: 


-e Print information about all processes. 

-d Print information about all processes, 
except process group leaders. 

-a Print information about all processes, 


except process group leaders and processes 
not associated with a terminal. 

~f Generate a full listing. (Normally, a short 
listing containing only process ID, terminal 
(“tty”) identifier, cumulative execution 
time, and the command name is printed.) 
See below for meaning of columns in a full 


listing. 
| Generate a long listing. See below. 
—ccorefile Use the file corefile in place of 
dev /kmem. 


~sswapdev Use the file swapdev in place of 
/dev/swap. This is useful when 
examining a_ corefile; a swapdev of 
/dev/null will cause the user block to be 
zeroed out. 

—n namelist The argument will be taken as the name of 
an alternate system namelist file in place 
of examining the running system. 

—t termltst Restrict listing to data about the processes 
associated with the terminals given in 
termlist. Terminal identifiers may be 
specified in one of two forms: the device’s 


Sc f= 


—p proclist 


—u utdlist 


—g grplist 
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file name (e.g., tty004) or if the device’s 
file name starts with tty, just the digit 
identifier (e.g., 004). 

Restrict listing to data about processes 
whose process ID numbers are given in 
procitst. 

Restrict listing to data about processes 
whose user ID numbers or login names are 
given in utdiist. In the listing, the 
numerical user ID will be printed unless the 
-f option is used, in which case the login 
name will be printed. 

Restrict listing to data about processes 
whose process groups are given in grplist. 


The column headings and the meaning of the columns in 
a ps listing are given below; the letters f and 1 indicate 
the option (full or long) that causes the corresponding 
heading to appear; all means that the heading always 
appears. Note that these two options determine only 
what information is provided for a process; they do not 
determine which processes will be listed. 


F (1) Flags (octal and additive) associated 
with the process: 
1 in core; 
2 system process; 
4 locked in core (e.g., for 
physical I/O); 
10 being swapped; 
20 being traced by another 
process; 
40 another tracing flag. 
Ss (1) The state of the process: 
0 non-existent; 
S sleeping; 
W waiting; 
R running; 
I intermediate; 
Z terminated; 
T stopped; 
xX growing. 

UID (f,1) The user ID number of the process 
owner; the login name is printed under 
the —f option. 

PID (all) The process ID of the process; it is 


possible to kill a process if you know 
this datum. 


PPID (f,1) | The process ID of the parent process. 
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Cc fl) Processor utilization for scheduling. 

PRI V The priority of the process; higher 
numbers mean lower priority. 

NI (1) Nice value; used in priority 
computation. 

SZ (1) The size in pages (4K bytes) of the 
core image of the process. 

RSZ (1) The resident size in pages (4K bytes) 


of the core image of the process. 

WCHAN (I) The event for which the process is 
waiting or sleeping; if blank, the 
process is running. 

STIME  (f) Starting time of the process. 

TTY all) The controlling terminal for the 
process. The t prefix implies a real 
terminal; the s prefix implies a shell 
layer; and the p prefix implies a 
virtual terminal. 

TIME (all) The cumulative execution time for the 

rocess. 

CMD (all) he command name; the full 
command name and its arguments are 
printed under the —f option. 


A process that has exited and has a parent, but has not 
yet been waited for by the parent, is marked 
<defunct>. 


Under the —f option, ps tries to determine the command 
name and arguments given when the process was created 
by examining memory or the swap area. Failing this, 
the command name, as it would appear without the -f 
option, is printed in square brackets. 


FILES 

/unix system namelist 

/dev/mem memory 

[dev /swap the default swap devices 

/etc/passwd supplies UID information 

dev searched to find terminal (‘‘tty’’) names 

SEE ALSO 

acetcom(L), kill(1), nice(1). 
BUGS 


Things can change while ps is running; the picture it 
gives is only a close approximation to reality. Some data 
printed for defunct processes are irrelevant. 
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NAME 

ptx — permuted index 
SYNOPSIS 

ptx [ options | [ input [ output | | 
DESCRIPTION 


Ptz generates the file output that can be processed with 
a text formatter to produce a permuted index of file 
input (standard input and output default). It has three 
phases: the first does the permutation, generating one 
line for each keyword in an input line. The keyword is 
rotated to the front. The permuted file is then sorted. 
Finally, the sorted lines are rotated so the keyword 
comes at the middle of each line. Ptz output is in the 
form: 


-xx “tail” "before keyword” "keyword and after” 
"head” 


where .xx is assumed to be an nroff or macro 
provided by the user, or provided by the mptz(5) macro 
package. The before keyword and keyword and after 
fields incorporate as much of the line as will fit around 
the keyword when it is printed. Tail and head, at least 
one of which is always the empty string, are wrapped- 
around pieces small enough to fit in the unused space at 
the opposite end of the line. 


The following options can be applied: 


—-f Fold upper and lower case letters for sorting. 
—t Prepare the output for the phototypesetter. 
-wn Use the next argument, n, as the length of 


the output line. The default line length is 
72 characters for nroff and 100 for troff. 


-gn Use the next argument, n, as the number of 
characters that ptr will reserve in its 
calculations for each gap among the four 
parts of the line as finally printed. The 
default gap is 3. 


—o only Use as keywords only the words given in the 
only file. 


-iignore Do not use as keywords any words given in 
the tgnore file. If the —i and —o options are 
missing, use /usr/lib/eign as the ignore 
file. 

—b break Use the characters in the break file to 
separate words. Tab, new-line, and space 
characters are always used as_ break 


Kits 


FILES 


SEE ALS 


BUGS 
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characters. 


-r Take any leading non-blank characters of 
each input line to be a reference identifier 
(as to a page or chapter), separate from the 
text of the line. Attach that identifier as a 
5th field on each output line. 


The index for this manual was generated using pitz. 


/bin/sort 
/usr/lib/eign 
/usr/lib/tmac/tmac.ptx 


O 
nroff(1), troff(1), mm(5), mptx(5). 


Line length counts do not account for overstriking or 
proportional spacing. 

Lines that contain tildes (~) are botched, because ptz 
uses that character internally. 


NAME 


PWCK(1M) 


pwek, grpck — password/group file checkers 


SYNOPSIS 


etc/pwek [file 
(eee \ fi ] 


DESCRIPTION 


FILES 


Pwck scans the password file and notes any 
inconsistencies. The checks include validation of the 
number of fields, login name, user ID, group ID, and 
whether the login directory and optional program name 
exist. The criteria for determining a valid login name is 
derived from passwd(4). The default password file is 
/etc/passwd. 


Grpck verifies all entries in the group file. This 
verification includes a check of the number of fields, 
group name, group ID, and whether all login names 
appear in the password file. The default group file is 
/etc/group. 


/etc/group 
/ete/passwd 


SEE ALSO 


group( 4), passwd(4). 
MightyFrame Administrator’s Reference Manual. 
MintFrame Administrator’s Manual. 


DIAGNOSTICS 


Group entries in /etc/group with no login names are 
flagged. 
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NAME 

pwd — working directory name 
SYNOPSIS 

pwd 
DESCRIPTION 


Pwd prints the path name of the working (current) 
directory. 


SEE ALSO 
ed(1). 

DIAGNOSTICS 
“Cannot open and ‘Read error in indicate 
possible file system trouble and should be referred to 
your system administrator. 


”? ” 


NAME 


QINSTALL (1) 


qinstall - install and verify software using the mkfs(1) 
proto file database 


SYNOPSIS 


local/bin/qinstall -e [ —esoi t 
fea scan ocean he eet | ea 


root 
/usr/local/bin/qinstall -r [{ -q ] proto root 
from_rfile to_rfile 


DESCRIPTION 


Qinstall is used to package software on distribution 
media, to install software, and to verify the correctness 


of the 
standard output. Root must be a full pathname or 


installation. Output from gqinstall goes to 


669? 


The following options are recognized by ginstall: 


-V 


—c 


-r 


output additional, verbose messages to stderr. 


check whether files under root match files in 
proto for owner and permission. This option is 
used primarily to verify the correctness of an 
installation, but it is also used in the software 
distribution packaging process. 


-o print omissions from root. 

-8 set permissions and owners to be correct 
if incorrect 

-e print extra files not found in proto 

-i ignore differences in special files 


—-m check mounted file systems as well 


generate a proto file from root. This option is 
used in the software distribution packaging 
process. 


-p add specified prefix to path names 
—t specify number of tabs to indent 


replace file to_rfile in root with contents of 

from_rfile, keeping permissions as in proto. 

To_rfile path must be a full path name as in the 

proto file, and will be offset with root. Multiple 

from/to pairs may be specified. This option is 
used to install customizable software. 

-q query before replace. Options are to 
replace to_rftile with from_rfile, to save 
from_rfile, to ignore to_rftile, to perform 
an sdiff(1) between the two files or to 
replace to_rfile with the previous diff. 


-1- 
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EXAMPLE 
A sample proto file created with the —g option follows. 
(qinstall —g . > ../proto) 


/mkboot 
00 
d-~777 22 
install d--77500 
IsamRel —~--4440 0 /install/IsamRel 
$ 
usr d--775 2 2 r 
include d--775 22 
isereh ---444 2 2 /usr/include/iserc.h 
isam.h —--444 2 2 /usr/include/isam.h 
$ 


lib d-~775 22 
isam d--775 22 


IsamConfig ---755 2 2 /usr/lib/isam/IsamConfig 
IsamCreate -—--755 2 2 /uar/lib/isam/IsamCreate 
IsamProtect ---755 2 2 /usr/lib/isam/IsamProtect 
IsamReorg —--755 2 2 /usr /lib/isam/IsamReorg 
IsamStat ---755 2 2 /usr/lib/isam/IsamStat 
IsamStop ---755 2 2 /usr/lib/isam/IsamStop 
IsamTransfer ---755 2 2 /usr/lib/isam/IsamTransfer 
LxFilter ---755 2 2 /usr/lib/isam/IxFilter 
IxSpec ---755 2 2 /usr/lib/isam/IxSpec 
isam —--755 2 2 fusr/lib/isam/isam | 
$ 
libisam.a ~-~444 22 /usr/lib/libisam.a | 
$ j 
$ 
$ 
SEE ALSO 
qlist(1), ctinstall(1), mkfs(1). 


BUGS 
Qinstall invoked with the —m option on an inconsistent 
file system produces error messages of the form 
“filename: cannot stat’’. 
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NAME 
qlist — print out file lists from proto file; set links based 
on lines in proto file. 


SYNOPSIS 
/usr/local/bin/qlist -m [| -d dir |] [ -o ] [| —p 
prefix | proto 
/usr/local/bin/qlist —1 dir | —p prefix ] proto 
/usr/local/bin/gqlist —s proto root 

DESCRIPTION 
Qlist is used in the distribution software packaging 
process and in the software installation process. It makes 
lists of files from proto files created by qinstall(1). Lists 
are based on the files’ group identifiers and types. Qitst 
also sets links based on lines in the proto file during 
software installation. 


Qlist understands extended proto files, in which a line 
beginning with :L indicates that the first file named is a 
link to the second file. Other lines beginning with : are 
comments. The last field on a line in an extended proto 
file is a group identifier of 9 or fewer characters, such as 
“WP” for the Word Processor product. The following 
symbols appearing immediately alter the group identifier 
designate the file’s type and have the following 
meanings: 

+ designates a customizable file, such as 
/etc/passwd. This type of file is one which 
the user may or may not want to install over his 
existing version. This type of file can be 
installed with the -rq option of ginatall(1). 


- designates a zero-length file. The specified file 
should not be used when updating an existing 
system; rather, it should be used for raw, or first 
installs only. 

@ implies an update but no query from ginstall(1). 
This symbol is used for files required by the 
installation tools for installation and for possible 
text busy files. 


< designates an optional file, or a file requiring 
special installation such as a hardware 
configuration-dependent file. Its associated 
special installation scripts are GROUP.opt and 
GROUP. ins, where GROUP represents the group 
name. 


< id designates a file of the above category which has 
special installation scripts named GROUPid.opt, 


<*fee 
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GROUPid.ins, where GROUP represents the 
group name. /d can be 5 or fewer characters. 
The total number of characters in GROUP and 
td must be 10 or fewer. 


The following options are recognized by glist: 


-V 
—-m 


EXAMPLE 


output additional, verbose messages to stderr. 


make file lists from proto file. This option is 
used in packaging software. 


-o print files in no group 
-d use dir as location for file lists 
—p use prefix when printing (default = ./) 


File lists output with the -m option for group 
“WP” are named as follows: 


+ WP..cust 

- WP..noup 

@ WP.noqu 

< WP.fopt, WP.fist 
< id WP..fopt, WPid.lst 
the rest WP 


list files in directory dir from proto file to stdout. 
-p use prefix when printing (default = ./) 


set links in root directory which are indicated by 
sL lines in proto file. Root must be a rooted path 
name or “.’’, This option is used in software 
installations. 


A sample extended proto file follows. Note that the files 
Document and Gloss are really links to the file 
Admin, as indicated by :L at the beginning of these 
lines. Also note that the lines ending in < designate 
optionally installed, or specially installed files. 


/mkboot 
00 
d-~-777 22 
install d--77500 

WPRel -~-444 00 /install/WPRel WP 

$ 
oa d--77500 

“Key d--75500 

Admin -~~444 2 2 /oa/.Key/Admin CTIXOA 

‘L Document /oa/.Key /Admin CTIXOA 


-2- 


-L Gloss 
$ 
Document 
Recruit 
$ 
-Gloss 
Sample 
$ 
Centronix 
ImagenDriver 
SerialDriver 
abs_rel 
ctos pool 
def_wp 
spoolstat 
wp_def 
wp_edit 
wp_merge 
wp_print 
wp_review 
wpp_band 
wpp_canprt 
wpp_diablo 
wpp_imagen 
wpp_laser 
wpp_necspin 
wpp_prtsh 
$ 


$ 
SEE ALSO 
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/oa/.Key/Admin 


d-~775 00 
—-~666 2 2 /oa/.Document/Recruit 


d-~775 00 
--~-666 2 2 /oa/.Gloss/Sample 


—-~555 2 2 /oa/Centronix WP< 
---555 2 2 /oa/ImagenDriverWP < 
---555 2 2 /oa/SerialDriver WP< 
--~555 2 2 /oa/abs_rel WP< 
---555 2 2 /oa/ctospool WP 
—--555 2 2 /oa/def_wp WP< 
--~555 22 /oa/spoolstat = WP 
---555 2 2 /oa/wp_def WP< 
---555 2 2 /oa/wp_edit WP 
---555 2 2 /oa/wp_merge WP 
---555 22 /oa/wp_print WP 
—---555 2 2 /oa/wp_review WP 
---555 22 /oa/wpp_band WP< 
--~6555 2 2 /oa/wpp_canprt WP 
---555 2 2 /oa/wpp_diablo WP< 
---555 2 2 /oa/wpp_imagen WP< 
---555 22 /oa/wpp_laser WP< 
—--555 2 2 /oa/wpp_necspin WP< 
---555 22 /oa/wpp_prtsh WP 


qinstall(1), ctinstall(1). 


CTIXOA 


WP 


WP 


sys 
sys 
sys 
propt 


propt 


propt 


propt 


propt 
propt 
propt 
propt 


NAME 


RCMD(1N) 


remd — remote shell command execution 


SYNOPSIS 


command 


a node [ -] user ] [{ —n | 
/usr/hosts/node { —1 user | [| —n } [ command } 


DESCRIPTION 


Remd sends command to node for execution. It passes 
the resulting remote command its own standard input 
and outputs the remote command’s standard output and 
standard error. Command can consist of more than one 
parameter. The second, simplified form of the command 
is equivalent to the first, but is only available if the 
system administrator previously ran mkhosts(1NM). 
Interrupt, quit, and terminate signals received by remd 
are also received by the remote command; remd 
normally terminates at the same time as the remote 
command. 


If command is omitted, remd simply runs rlogin(1N). 


By default, the command belongs to the user on the 
remote node with the same name as the user who ran 
remd. This means that the resulting processes belong to 
the remote user and begin with the remote user’s home 
directory as their working directory. Options permit you 
to specify another user on node as the owner. In any 
case, the remote system must have declared the local 
user equivalent to the remote user. 


Remd understands the following options: 


~luser The command is to belong to user on 
node. 


—n Prevent the remote command from 
blocking on input by making its 
standard input be /dev/null instead 
of remd’s standard input. 


EXAMPLES 


The following command runs who on a node called 
“central,” putting the output in a file on the local 
machine. 


remd central who > /tmp/c.who 


The next example puts the same output on the remote 
machine 


remd central who \> /tmp/c.who 


SEE ALSO 


rlogin(1N). 


RCMD(1N) 


NOTE 
In some installations, this command is called rsh, so as 
to be like other versions of the software. 


WARNINGS 
As the above examples illustrate, metacharacters to be 
interpreted by the remote shell must be hidden from the 
local shell. Thus 


remd central cd /etc ; cat passwd 


clearly doesn’t do what was intended because the 
semicolon is interpreted by the local shell, not the 
remote shell, and the remote shell never even sees the 
cat command. Either of the following commands 
properly escapes the semicolon: 


remd central cd /etc \; cat passwd 
remd central 'cd /etc ; cat passwd! 


NAME 


RCP(1N) 


rep — remote file copy 


SYNOPSIS 


/usr/local/bin/rep | —r | filel [ file2 ... | target 


DESCRIPTION 
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Rep copies files between two nodes. Rep works like the 
cp command (see cp(1)), with some extensions but 
without an option to specify PILF cluster size. 


Filel is copied to target. If target is a directory, one or 
more files are copied into that directory; the copies have 
the same names as the originals. 


File and directory names follow a convention which is an 
extension of the normal CTIX convention. Names take 
one of three forms: 


host .user:path 
host:path 
path 


where 


host is the name of the system which contains 
or will contain the file. If no host is 
specified (the simple path form of the 
name), the system on which the 
command is executed is assumed. 


user is the name of a user on the specified 
system. If no user is specified (the 
hostspath and path forms of the name), 
the user on the remote system whose 
name is the same as the user who 
executed the rep command is used. 


Access to the file system is as if by the 
specified user who has just logged in. 
Created files belong to the specified user 
and the specified user’s group (taken 
from the password file). File and 
directory modifications can only occur if 
the specified user has permission to do 
them. If path does not begin with a slant 
(/), it is assumed to be relative to the 
specified user’s home directory. 


To use a user name on a remote system, 
the remote system must have declared it 
“equivalent” to your user name. See 
rhosts(4N). 


RCP(1N) 


path is a conventional CTIX/UNIX path name. 
Path can include file name generation 
sequences (*, ?, [...]); it may be 
necessary to quote these to prevent their 
expansion on the local system. 


An exclamation point (!) is allowed in place of the colon. 


The —r (recursive) option copies directory hierarchies. If 
a file specified for copying is a directory and —r is 
specified, the entire hierarchy under it is copied. When 
—r is specified, target must be a directory. 


When —r is not specified, copying directories is an error. 


Note that a third system (not the source or target system 
of the copy) can execute rep. 


EXAMPLES 


FILES 


The following examples are executed on system alpha, by 
user fred. Alpha is networked to beta and gamma. 


The first example copies /tst from fred’s home directory 
on alpha to fred’s home directory on beta. 


rep list beta:list 


The next example copies a directory hierarchy. The 
original is rooted at sre in fred’s home directory on beta. 
The copy is to be rooted in sre in the working directory. 


rcp —r beta:sre . 


Finally, fred copies a file from diane’s home directory on 
beta to /usr/tmp on gamma; the copy on gamma is to 
belong to karl. Both diane and karl must have 
previously declared fred on alpha equivalent to their own 
user names; see rhosts(4N). 


rep beta.diane:junk gamma.karl:/usr/tmp 


Note that junk is not placed in karl’s home directory 
because the path part of the name begins with a slash. 


/etc/hosts.equiv 
$HOME/.rhosts 


REQUIREMENTS 


Both nodes involved in the copy must be running the 
rshd(1NM) server. 


DIAGNOSTICS 


Most diagnostics are self-explanatory. ‘‘Permission 
denied”’ means either that the remote user does not have 
permission to do what you want or that the remote user 
is not equivalent to you. 


RCP(1N) 


WARNINGS 
If a remote shell invoked by rep has output on startup, 
rep will get confused. This is never a problem with 
sh(1), because it is not called as a login shell. 


The —r option doesn’t work correctly if the copy is 
purely local. Use cpto(1), instead. 


REBOOT (1M) 


NAME 

reboot — reboot the system 
SYNOPSIS 

/etc/reboot 
DESCRIPTION 


Reboot issues a syslocal(2) call to ask the system to wait 
for the disks to become quiescent and then to reboot the 
system. The reboot procedure is identical to power-on 
reset except that the system will not try to take a crash 
dump. 


Only super-user is allowed to execute reboot. 


REGCMP (1) 


NAME 

regemp — regular expression compile 
SYNOPSIS 

regemp [ — | files 
DESCRIPTION 


Regemp, in most cases, precludes the need for calling 
regemp(3X) from C programs. This saves on both 
execution time and program size. The command regemp 
compiles the regular expressions in file and places the 
output in file.i. If the — option is used, the output will 
be placed in file.c. The format of entries in file is a 
name (C variable) followed by one or more blanks 
followed by a regular expression enclosed in double 
quotes. The output of regemp is C source code. 
Compiled regular expressions are represented as extern 
char vectors. File.i files may thus be included into C 
programs, or file.c files may be compiled and later 
loaded. In the C program which uses the regemp 
output, regez(abe line) will apply the regular expression 
named abe to line. Diagnostics are self-explanatory. 


EXAMPLES 


name "({A~Za~z]{A-Za-—z0-9_]*)$0” 
telno ‘Sao aN ey {0,1} *” 


In the C program that uses the regemp output, 





regex(telno, line, area, exch, rest) 
will apply the regular expression named telno to line. 


SEE ALSO 


regemp(3X). 


NAME 


RENICE(1) 


renice — alter priority of running process by changing 
nice 


SYNOPSIS 


/etc/renice pid | priority | 


DESCRIPTION 


FILES 


Renice can be used by the super-user to alter the priority 
of a running process. By default, the nice of the process 
is made 19, which means that it will run only when 
nothing else in the system wants to. This can be used to 
nail long running processes that are interfering with 
interactive work. 


Renice can be given a second argument to choose a nice 
other than the default. Negative nices can be used to 
make things go very fast. 


/unix 
/dev/kmem 


SEE ALSO 


BUGS 


nice(1). 


If you make the nice very negative, then the process 
cannot be interrupted. To regain control you must put 
the nice back (e.g., to 0). 


REXECD ( 1NM) 


NAME 

rexecd — remote execution server 
SYNOPSIS 

/ete/rexecd 
DESCRIPTION 
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Rezecd is the server for the rezec(3X) routine. The 
server provides remote execution facilities with 
authentication based on user names and encrypted 
passwords. 


Rezecd listens for service requests at the port indicated 

in the “exec”? service specification; see services(4N). 

When a service request is received the following protocol 

is initiated: 

1) The server reads characters from the socket up 
to a null (\0) byte. The resultant string is 
interpreted as an ASCII number, base 10. 


2) If the number received in step 1 is nonzero, it is 
interpreted as the port number of a secondary 
stream to be used for the stderr. A second 
connection is then created to the specified port 
on the client’s machine. 


3) A null-terminated user name of at most 16 
characters is retrieved on the initial socket. 

4) A null-terminated, encrypted, password of at 
most 16 characters is retrieved on the initial 
socket. 

5) A null-terminated command to be passed to a 


shell is retrieved on the initial socket. The 
length of the command is limited by the upper 
bound on the size of the system’s argument list. 


6) Rezxecd then validates the user as is done at 
login time and, if the authentication was 
successful, changes to the user’s home directory 
and establishes the user and group protections of 
the user. If any of these steps fail, the 
connection is aborted with a diagnostic message 
returned. 


7) A null byte is returned on the connection 
associated with the stderr and the command line 
is passed to the normal login shell of the user. 
The shell inherits the network connections 
established by rezecd. 


REXECD(1NM) 


DIAGNOSTICS 


BUGS 
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All diagnostic messages are returned on the connection 
associated with the stderr, after which any network 
connections are closed. An error is indicated by a 
leading byte with a value of 1 (0 is returned in step 7 
above upon successful completion of all the steps prior to 
the command execution). 


“username too long” 
The name is longer than 16 characters. 
‘password too long”’ 
The password is longer than 16 characters. 
“command too long”’ 
The command line passed exceeds the size of the 
argument list (as configured into the system). 
“Login incorrect.” 
No password file entry for the user name existed. 
“Password incorrect.” 
The wrong password was supplied. 
‘‘No remote directory.” 
The chdir command to the home directory failed. 
“Try again.” 
A fork by the server failed. 
‘*/bin/sh: ...”” 

he user’s login shell could not be started. 


Indicating ‘Login incorrect’? as opposed to “Password 
incorrect” is a security breach which allows people to 
probe a system for users with null passwords. 


A facility to allow all data exchanges to be encrypted 
should be present. 


NAME 


RLOGIN(1N) 


rlogin — remote login 


SYNOPSIS 


/usr/local/bin/rlogin node [ —ec —I name 
/usr /hosts/node i: 1 [ | ae | | 


DESCRIPTION 


Rlogin connects you to a login shell executing on node. 
The second, simplified form of the command is 
equivalent to the first, but is available only if 
mkhosts(1NM) was previously run by the system 
administrator. By default rlogin uses the same user 
name on the remote node that the user is using on the 
local node. The remote login program will not require a 
password if the remote node has declared the two users 
equivalent (see rhosts(4N)). 


Rlogin attempts to configure the remote “terminal”’ in a 
convenient way. The TERM environment variable on the 
remote shell is automatically set to match its value on 
the local shell which ran rlogin. Echoing takes place at 
the remote node. Flow control on XON/XOFF and 
flushing of input and output on interrupts are handled 
properly. 

Close the connection by hanging up on rlogin, by loggin 

out of the remote node, or by typing ‘‘~.” (tilde-period 

at the beginning of a line. The hangup and the tilde- 
period command both cause a hangup on the remote 
“terminal.” To send an input line beginning with tilde to 
the remote node, begin the line with two tildes. 


Rlogtn understands the following options. 


—ec Use the character c¢ instead of tilde as the 
escape character. There must not be a space 
between e and c on the command line. A c- 
period at the beginning of an input line closes 
the connection, and cc at the beginning of an 
input line sends a single c. 


—luser Login as user on the remote system. User’s 
password is not required provided that the 
local user name is on _ user’s list of 
“equivalent” user names. See rhosts(4N). 


SEE ALSO 


5/86 


remd(1N), rhosts(4N). 
CTIX Internetworking Manual. 


RLOGIND(1NM) 


NAME 
rlogind — remote login server 

SYNOPSIS 
/ete/rlogind 

DESCRIPTION 
Rlogind is a network server which supports remote logins 
by programs such as rlogin(1N). It is normally executed 
by the startup file, /ete/re. 
Rlogind enforces an authentication procedure based on 
equivalence of user names (see rhosts(4N)). This 
procedure assumes all nodes on the network are equally 
secure. 

SEE ALSO 


rlogin(1N), rhosts(4N). 


EDIT (1) 


“put a” to put the contents of buffer a after the current 
line. If you want to move or copy these lines between 
files you can give an edit (e) command after copying the 
lines, following it with the name of the other file you 
wish to edit, i.e., ‘edit chapter2”. By changing delete to 
yank above you can get a pattern for copying lines. If 
the text you wish to move or copy is all within one file 
then you can just say ‘‘10,20move $”’ for example. It is 
not necessary to use named buffers in this case (but you 
can if you wish). 


SEE ALSO 
ex(1), vi(1). 


NAME 


ENABLE(1) 


enable, disable — enable/disable LP printers 


SYNOPSIS 


enable printers 
disable [—c] [—r[ reason } ] printers 


DESCRIPTION 


FILES 


Enable activates the named printers, enabling them to 
print requests taken by /p(1). Use Ipstat(1) to find the 
status of printers. 


Disable deactivates the named printers, disabling them 
from printing requests taken by /p(1). By default, any 
requests that are currently printing on the designated 
printers will be reprinted in their entirety either on the 
same printer or on another member of the same class. 
Use Ipstat(1) to find the status of printers. Options 
useful with disable are: 


—¢ Cancel any requests that are currently 
printing on any ofthe designated printers. 


-r{ reason] Associates a reason with the deactivation 
of the printers. This reason applies to all 
printers mentioned up to the next —-r 
option. If the —r option is not present or 
the -—r option is given without a reason, 
then a default reason will be used. 
Reason is reported by Ipstat(1). 


/usr/spool/lp/* 


SEE ALSO 


Ip(1), Ipstat(1). 
MightyFrame Administrator’s Reference Manual. 
MintFrame Admintstrator’s Manual. 


EDIT(1) 


become line 1, and edit will print the current line (the 
new line 1) so you can see where you are. In general, the 
current line will always be the last line affected by a 
command. 


You can make a change to some text within the current 
line by using the substitute (s) command. You say 
“s/old /new/” where old is replaced by the old 
characters you want to get rid of and new is the new 
characters you want to replace it with. 


The command file (f) will tell you how many lines there 
are in the buffer you are editing and will say 
ai Modified)” if you have changed it. After modifying a 
file you can put the buffer text back to replace the file 
by giving a write (w) command. You can then leave 
the editor by issuing a quit (q) command. If you run 
edit on a file, but do not change it, it is not necessary 
(but does no harm) to write the file back. If you try to 
quit from edit after modifying the buffer without writing 
it out, you will be warned that there has been ‘‘No 
write since last change” and edit will await another 
command. If you wish not to write the buffer out then 
you can issue another quit command. The buffer is then 
irretrievably discarded, and you return to the shell. 


By using the delete and append commands, and giving 
line numbers to see lines in the file you can make any 
changes you desire. You should learn at least a few 
more things, however, if you are to use edit more than a 
few times. 


The change (c) command will change the current line to 
a sequence of lines you supply (as in append you give 
lines up to a line consisting of only a ‘‘.””). You can tell 
change to change more than one line by giving the line 
numbers of the lines you want to change, i.e., 
“3,5change’’. You can print lines this way too. Thus 
‘*1,23p”’ prints the first 23 lines of the file. 


The undo (u) command will reverse the effect of the last 
command you gave which changed the buffer. Thus if 
you give a substitute command which does not do what 
you want, you can say undo and the old contents of the 
line will be restored. You can also undo an undo 
command so that you can continue to change your mind. 
Edit will give you a warning message when commands 
you do affect more than one line of the buffer. If the 
amount of change seems unreasonable, you should 
consider doing an undo and looking to see what 
happened. If you decide that the change is ok, then you 
can undo again to get it back. Note that commands 


-2- 


a ee 


EDIT(1) 


such as write and qutt cannot be undone. 


To look at the next line in the buffer you can just hit 
carriage return. To look at a number of lines hit “D 
(control key and, while it is held down D key, then let 
up both) rather than carriage return. This will show you 
a half screen of lines on a CRT or 12 lines on a hardcopy 
terminal. You can look at the text around where you are 
by giving the command ‘‘z.”’. The current line will then 
be the last line printed; you can get back to the line 
where you were before the ‘‘z.”” command by saying 
«°) The £ command can also be given other following 
characters ‘“‘z—’? prints a screen of text (or 24 lines) 
ending where you are; ‘‘z+’’ prints the next screenful. If 
you want less than a screenful of lines, type in ”z.12” to 
get 12 lines total. This method of giving counts works in 
general; thus you can delete 5 lines starting with the 
current line with the command ‘“‘delete 5”. 


To find things in the file, you can use line numbers if 
you happen to know them; since the line numbers change 
when you insert and delete lines this is somewhat 
unreliable. You can search backwards and forwards in 
the file for strings by giving commands of the form 
(ey to search forward for tert or ?text? to search 
ackward for tezt. If a search reaches the end of the file 
without finding the text it wraps, end around, and 
continues to search back to the line where you are. A 
useful feature here is a search of the form /*text/ which 
searches for tert at the beginning of a line. Similarly 
per, searches for text at the end of a line. You can 
eave off the trailing / or ? in these commands. 


The current line has a symbolic name “.’’; this is most 
useful in a range of lines as in “.,$print”’? which prints 
the rest of the lines in the file. To get to the last line in 
the file you can refer to it by its symbolic name “$”’. 
Thus the command ‘“‘$ delete” or ‘“‘$d’’ deletes the last 
line in the file, no matter which line was the current line 
before. Arithmetic with line references is also possible. 
Thus the line ‘‘$-5” is the fifth before the last, and 
“+20” is 20 lines after the present. 

” 


You can find out which line you are at by doing ‘.=’’. 
This is useful if you wish to move or copy a section of 
text within a file or between files. Find out the first and 
last line numbers you wish to copy or move (say 10 to 
20). For a move you can then say ‘‘10,20delete a” which 
deletes these lines from the file and places them in a 
buffer named a. Edit has 26 such buffers named a 
through z. You can later get these lines back by doing 


236 


NAME 


CUT(1) 


cut — cut out selected fields of each line of a file 


SYNOPSIS 


cut —clist | filel file2 ... 
cut —flist |~d char} [-s 





[filel file2 ...] 


DESCRIPTION 


HINTS 


Use cut to cut out columns from a table or fields from 
each line of a file; in data base parlance, it implements 
the projection of a relation. The fields as specified by 
list can be fixed length, i.e., character positions as on a 
punched card (—e option), or the length can vary from 
line to line and be marked with a field delimiter 
character like tab (-f option). Cut can be used as a 
filter; if no files are given, the standard input is used. 


The meanings of the options are: 


list A comma-separated list of integer field 
numbers (in increasing order), with optional — 
to indicate ranges as in the —o option of 
nroff/troff for page ranges; e.g., 1,4,7; 1-3,8; 
—5,10 (short for 1-5,10); or 3— (short for 
third through last field). 


—clist The list following -c (no space) specifies 
character positions (e.g.. —cl—72 would pass 
the first 72 characters of each line). 


-flist The list following —f is a list of fields assumed 
to be separated in the file by a delimiter 
character (see —d ); e.g., —f1,7 copies the first 
and seventh field only. Lines with no field 
delimiters will be passed through intact (useful 
for table subheadings), unless —s is specified. 


-dchar The character following -d is the field 
delimiter (—f option only). Default is tab. 
Space or other characters with special meaning 
to the shell must be quoted. 


—8 Suppresses lines with no delimiter characters in 
case of —f option. Unless specified, lines with 
no delimiters will be passed through untouched. 


Either the —c or —f option must be specified. 


Use grep(1) to make horizontal ‘cuts’ (by context) 
through a file, or paste(1) to put files together column- 
wise Re: horizontally). To reorder columns in a table, 
use cut and paste. 


CUT (1) 


EXAMPLES 
cut —d: -f1,5 /etc/passwd mapping of user IDs 
to names 
name=*‘who ami|cut -fl—-d” "* to set name to 
current login name. 
DIAGNOSTICS 
line too long A line can have no more than 1023 
characters or fields. 
bad list for c / f option 
Missing -—c or -—f option or 
incorrectly specified list. No error 
occurs if a line has fewer fields than 
the ltst calls for. 
no fields The list is empty. 


SEE ALSO 
grep(1), paste(1). 


CTINSTALL(1) 


/dev/dsk /c0d0s3 
File System: Volume: 


** Phase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 
** Phase 5 - Check Free List 

NNN files NNNN blocks NNNN free 


Re-mounting /usr. 


Please enter your group choices for ISAM separated by blanks. 
Your choices are: 


ISAM 
If you’d like all of the groups, type ’all’: ISAM 
This procedure will install the following ISAM 5.00 group(s) on your system: 
ISAM 


BE SURE YOU BACK UP ANYTHING YOU HAVE CHANGED 
BEFORE PROCEEDING. 


Type ‘yes’ to continue: yes 


Starting to Install Group(s) ISAM. 
Installing Group ISAM. 


Calculating size required for group ISAM. 

Installation will require an additional NNN root Blocks (512 Byte Blocks). 
(Currently NNNN 512 Byte blocks are available on root.) 

Installation will require an additional NNN /usr Blocks (512 Byte Blocks). 
(Currently NNNN 512 Byte blocks are available on /usr.) 


Installing required ISAM files. 
install /IsamRel 

usr /include/isam.h 

usr /include/iserc.h 

usr/lib /isam/IsamConfig 
usr/lib /isam/IsamCreate 
usr/lib /isam/IsamProtect 
usr/lib /isam/IsamReorg 
usr /lib /isam/IsamStat 
usr/lib /isarmn/IsamStop 
usr/lib /isam/IsamTransfer 
usr/lib /isam/IxFilter 


CTINSTALL (1) 


usr /lib/isam/IxSpec 
usr /lib/isam/isam 


Checking permissions, modes and omissions on new JSAM commands. 
Completed Installation of Group ISAM. 
Rewinding tape. 


Installation Complete. 
SEE ALSO 
qlist(1), qustalltt): 
Release Notice for software product being installed. 
BUGS 
Ctinstall does not understand mountable file systems 
other than /usr. 


CTRACE(1) 


NAME 

ctrace — C program debugger 
SYNOPSIS 

ctrace [ options | [ file ] 
DESCRIPTION 


Ctrace allows you to follow the execution of a C 
program, statement by statement. The effect is similar 
to executing a shell procedure with the —x option. 
Ctrace reads the C program in file (or from standard 
input if you do not specify file), inserts statements to 
print the text of each executable statement and the 
values of all variables referenced or modified, and writes 
the modified program to the standard output. You must 
put the output of ctrace into a temporary file because 
the cc(1) command does not allow the use of a pipe. 
You then compile and execute this file. 


As each statement in the program executes it will be 
listed at the terminal, followed by the name and value of 
any variables referenced or modified in the statement, 
followed by any output from the statement. Loops in 
the trace output are detected and tracing is stopped until 
the loop is exited or a different sequence of statements 
within the loop is executed. A warning message is 
printed every 1000 times through the loop to help you 
detect infinite loops. The trace output goes to the 
standard output so you can put it into a file for 
examination with an editor or the bfs(1) or tail(1) 
commands. 


The only options you will commonly use are: 


-f functions Trace only these functions. 
-v functions Trace all but these functions. 


You may want to add to the default formats for printing 
variables. Long and pointer variables are always printed 
as signed integers. Pointers to character arrays are also 
printed as strings if appropriate. Char, short, and int 
variables are also printed as signed integers and, if 
appropriate, as characters. Double variables are printed 
as floating point numbers in scientific notation. You can 
request that variables be printed in additional formats, if 
appropriate, with these options: 


-o Octal 
-x Hexadecimal 
-u Unsigned 


-e Floating point 
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These options are used only in special circumstances: 


—In Check n consecutively executed statements for 
looping trace output, instead of the default of 20. 
Use 0 to get all the trace output from loops. 

-8 Suppress redundant trace output from simple 
assignment statements and string copy function 
calls. This option can hide a bug caused by use 
of the = operator in place of the == operator. 

—tn Trace n variables per statement instead of the 
default of 10 (the maximum number is 20). The 
Diagnostics section explains when to use this 
option. 

-P Run the C preprocessor on the input before 
tracing it. You can also use the —D, —I, and -U 
ee(1) preprocessor options. 


These options are used to tailor the run-time trace 
package when the traced program will run in an 
environment other than CTIX or other UNIX-compatible 
systems: 


-b Use only basic functions in the trace code, that 
is, those in ctype(3C), print{(3S), and string(3C). 
These are usually available even in cross 
compilers for microprocessors. In particular, this 
option is needed when the traced program runs 
under an operating system that does not have 
stgnal(2), fflush(3S), longjmp(3C), or achmetscl 

~-p ’s’ Change the trace print function from the defau 
of ’printf(’. For example, fprintf(stderr,’ would 
send the trace to the standard error output. 

-rf Use file fin place of the runtime.c trace function 
package. This lets you change the entire print 
function, instead of just the name and leading 
arguments (see the -p option). 


EXAMPLE 
If the file le.c contains this C program: 


1 #include <stdio.h> 


2 main() /* count lines in input */ 
3 

4 int c, nl; 

5 

6 nl = 0; 

7 while ((c = getchar()) != EOF) 
8 if (c = ’\n’) 

9 +-+nl; 

10 printf(”%d\n", nl); 
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and you enter these commands and test data: 


ce le.c 
a.out 


1 

(cntl-d), 
the program will be compiled and executed. The output 
of the program will be the number 2, which is not 
correct because there is only one line in the test data. 
The error in this program is common, but subtle. If you 
invoke cfrace with these commands: 


ctrace le.c >temp.c 
ce temp.c 
a.out 


the output will be: 


7 while ((¢ = nO) !— EOF) 


The program is now waiting for input. If you enter the 
same test data as before, the output will be: 


/* ¢ == 49 or ’1’ */ 
8 if (c = ’\n’) 
/* ¢ == 10 or ’\n’ */ 
++nl; 
c nl == 1 * 
7 while ((c = getchar()) != EOF) 
/* ¢ == 10 or ’\n’ */ 
8 if (c = ’\n’) 
/* ¢ == 10 or ’\n’ */ 
9 ++nl; 


(: nl == 2 * 
7 while ((c = getchar()) != EOF) 


If you now enter an end of file character (cntl-d) the 
final output will be: 
nf Ma 
10 printf("%d\n", nl); 
/* nl == 2*/2 


return 


Note that the program output printed at the end of the 
trace line for the nl variable. Also note the return 
comment added by ctrace at the end of the trace output. 
This shows the implicit return at the terminating brace 
in the function. 
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The trace output shows that variable ¢ is assigned the 
value ’1’ in line 7, but in line 8 it has the value ’\n’. 
Once your attention is drawn to this if statement, you 
will probably realize that you used the assignment 
operator (=) in place of the equal operator ay You 
can easily miss this error during code reading. 


EXECUTION-TIME TRACE CONTROL 
The default operation for ctrace is to trace the entire 
program file, unless you use the -f or -v options to trace 
specific functions. This does not give you statement by 
statement control of the tracing, nor does it let you turn 
the tracing off and on when executing the traced 
program. 


You can do both of these by adding ctroff() and ctron() 
function calls to your program to turn the tracing off 
and on, respectively, at execution time. Thus, you can 
code arbitrarily complex criteria for trace control with if 
statements, and you can even conditionally include this 
code because ctrace defines the CTRACE preprocessor 
variable. For example: 


#ifdef CTRACE 
if (c == ’P && i > 1000) 
ctron(); 
#endif 


You can also call these functions from sdb(1) if you 
compile with the -g option. For example, to trace all 
but lines 7 to 10 in the main function, enter: 


sdb a.out 
main:7b ctroff() 
main:11b ctron() 
r 


‘You can also turn the trace off and on by setting static 
variable tr_ct_ to 0 and 1, respectively. This is useful if 
you are using a debugger that cannot call these functions 
directly, such as adb(1). 


DIAGNOSTICS 
This section contains diagnostic messages from both 
ctrace and cc(1), since the traced code often gets some 
ce warning messages. You can get cc error messages in 
some rare cases, all of which can be avoided. 


Ctrace Diagnostics 
warning: some variables are not traced tn this statement 
Only 10 variables are traced in a statement to 


Ze 


CTRACE(1) 


prevent the C compiler "out of tree space; 
simplify expression” error. Use the -t option to 
increase this number. 


warning: statement too long to trace 
This statement is over 400 characters long. 
Make sure that you are using tabs to indent your 
code, not spaces. 


cannot handle preprocessor code, use -P option 
This is usually caused by #ifdef/#endif 
preprocessor statements in the middle of a C 
statement, or by a semicolon at the end of a 
#define preprocessor statement. 


“af ... else tf’ sequence too long 
Split the sequence by removing an else from the 
middle. 


possible syntaz error, try -P option 
Use the -P option to preprocess the cfrace input, 
along with any appropriate -D, -I, and -U 
preprocessor options. If you still get the error 
message, check the Warnings section below. 


Cc Diagnostics 
warning: floating potnt not tmplemented 
warning: tllegal combination of pointer and integer 
warning: statement not reached 
warning: sizeof returns 0 
Ignore these messages. 


compiler takes size of function 
See the ctrace "possible syntax error” message 
above. 


yacc stack overflow 
See the ctrace "if ... else if? sequence too long” 
message above. 


out of tree space; simplify expression 
Use the -t option to reduce the number of traced 
variables per statement from the default of 10. 
Ignore the "ctrace: too many variables to trace” 
warnings you will now get. 


redeclaratton of signal 
Either correct this declaration of signal(2), or 
remove it and #include <signal.h>. 
WARNINGS 
You will get a ctrace syntax error if you omit the 
semicolon at the end of the last element declaration in a 
structure or union, just before the right brace (}). This 
is optional in some C compilers. 


oer 


BUGS 


FILES 
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Defining a function with the same name as a system 
function may cause a syntax error if the number of 
arguments is changed. Just use a different name. 


Ctrace assumes that BADMAG is a preprocessor macro, 
and that EOF and NULL are #defined constants. 
Declaring any of these to be variables, e.g. "int EOF;”, 
will cause a syntax error. 


Ctrace does not know about the components of 
aggregates like structures, unions, and arrays. It cannot 
choose a format to print all the components of an 
aggregate when an assignment is made to the entire 
aggregate. Ctrace may choose to print the address of an 
aggregate or use the wrong format (eg., %e for a 
structure with two integer members) when printing the 
value of an aggregate. 


Pointer values are always treated as pointers to 
character strings. 


The loop trace output elimination is done separately for 
each file of a multi-file program. This can result in 
functions called from a loop still being traced, or the 
elimination of trace output from one function in a file 
until another in the same file is called. 


runtime.c run-time trace package 


SEE ALSO 


signal(2), ctype(3C), fflush(3S), longjmp(3C), printf(3S), 
setjmp(3C), string(3C). 
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NAME 
cu — call another computer system 

SYNOPSIS 
cu {-—sspeed| [-lIline] [—-h] [-t] [-d] [-m]}] 
{-o] [-e] [—n] telno | systemname 

DESCRIPTION 
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Cu calls up another computer system or a terminal. It 
manages an interactive conversation with possible 
transfers of ASCII files. 


Cu accepts the following options and arguments. 


—sspeed 
Specifies the transmission speed (110, 150, 300, 
600, 1200, 4800, 9600); 300 is the default value. 
Directly connected lines may be set to a speed 
higher than 1200 baud. 


-lline Specifies a device name to use as_ the 
communication line. This can be used to 
override searching for the first available line 
having the right speed. When the —I option is 
used without the —s option, the speed of a line is 
taken from the file /usr/lib/uucp/Devices. 
When the -I and ~s options are used 
simultaneously, cu will search the Devices file 
to check if the requested speed for the requested 
line is available. If so, the connection will be 
made at the requested speed; otherwise an error 
message will be printed and the call will not be 
made. The specified device is generally a directly 
connected asynchronous line (e.g., 
[dev /tty zzz); in this case a telephone number 
is not required. If the specified device is 
associated with an auto dialer, a telephone 
number must be provided. 

—h Emulates local echo, supporting calls to other 
computer systems which expect terminals to be 
set to half-duplex mode. 

—t Used when dialing an ASCII terminal which has 


been set to auto answer. Appropriate mapping 
of carriage-return to  carriage-return-line-feed 


pairs is set. 
-d Causes diagnostic traces to be printed. 
—e Designates that even parity is to be generated 


for data sent to the remote system. (This option 
cannot be used with the —o option.) 
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-o Designates that odd parity is tobe generated for 
data sent to the remote system. (This option 
cannot be used with the —e option.) 


-m Designates a direct line that has modem control. 


—n Will request the telephone number to be dialed 
from the user rather than taking it from the 
command line. 


telno When using an automatic dialer, the argument is 
the telephone number with equal signs for 
secondary dial tone or minus signs for delays, at 
appropriate places. 


systemname 

A UUCP system name may be used rather than a 
telephone number; in this case, eu will obtain an 
appropriate direct line or telephone number from 
/usr /lib/uucp/Systems (the appropriate baud 
rate 1s also read along with telephone numbers). 
Cu will try each phone number or direct line for 
systemname in the Systems file until a 
connection is made or all the entries are tried. 


After making the connection, cu runs as two processes: 
the transmit process reads data from the standard input 
and, except for lines beginning with ~, passes it to the 
remote system; the receive process accepts data from the 
remote system and, except for lines beginning with ~, 
passes it to the standard output. Normally, an 
automatic DC3/DC1 protocol is used to control input 
from the remote so the buffer is not overrun. Lines 
beginning with ~ have specia] meanings. 


The transmit process interprets the following: 


ey terminate the conversation. 

“ft escape to an interactive shell on 
the local system. 

“lemd... run emd on the local system (via 
sh —c). 

“$emd... run emd locally and send _ its 


output to the remote system. 


~“%ed change the directory on the local 
system. NOTE: “!ed will cause 
the command to be run by a 
sub-shell; probably not what 
was intended. 
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“Ytake from [ to | copy file from (on the remote 
system) to file fo on the local 
system. If to is omitted, the from 
argument is used in both places. 


“%put from { to | copy file from (on local system) to 
file to on remote system. If ¢éo is 
omitted, the from argument is 
used in both places. 


send the line ~... to the remote 
system. 
~%break transmit a BREAK to the 


remote system. 


~%nostop toggles between DC3/DC1 input 
control protocol and no input 
control. This is useful in case the 
remote system is one which does 
not respond properly to the DC3 
and DC1 characters. 


The receive process normally copies data from the 
remote system to its standard output. A line from the 
remote that begins with ~> initiates an output diversion 
to a file. The complete sequence is: 

“> [>] s file 

zero or more lines to be written to file 

“> 


Data from the remote is diverted (or appended, if >> is 
used) to file. The trailing ~> terminates the diversion. 


The use of “%put requires stty(1) and cat(1) on the 
remote side. It also requires that the current erase and 
kill characters on the remote system be identical to the 
current ones on the local system. Backslashes are 
inserted at appropriate places. 


The use of “%take requires the existence of echo(1) and 
cat(1) on the remote system. Also, stty tabs mode 
should be set on the remote system if tabs are to be 
copied without expansion. 


When cu is used on system X to connect to system Y 
and subsequently used on system Y to connect to system 
Z, commands on system Y can be executed by using ~~. 
For example, uname can be executed on Z, X, and Y as 
follows: 


uname 
Z 


“tuname 
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Xx 


“~tuname 


In general, © causes the command to be executed on the 
original machine, ~~ causes the command to be executed 
on the next machine in the chain. 


EXAMPLES 


FILES 


To dial a system whose number is 9 201 555 1212 using 
1200 baud: 
cu -sl200 9= 2015551212 


If the speed is not specified, 300 is the default value. 
To login to a system connected by a direct line: 


cu -l /dev/ttyXXX 
To dial a system with the specific line and a specific 
speed: 

cu -s1200 -] /dev/ttyXXX 
To dial a system using a specific line: 

cu -] /dev/culXX 2015551212 


To use a system name: 
cu YYYZZZ 


usr/lib/uucp /Systems 
pase pane pyre 
/usr/spool /locks/LCK.* 
/dev /null 
/usr/lib/uucp /Dialcodes 


SEE ALSO 


eat(1), ct(1C), echo(1), stty(1), uname(1), uucp(1C). 
MightyFrame Administrator’s Reference Manual. 


DIAGNOSTICS 


BUGS 
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Exit code is zero for normal exit, non-zero (various 
values) otherwise. 


Cu buffers input internally. 

There is an artificial slowing of transmission by cu 
during the “%put operation so that loss of data is 
unlikely. 


(.)i 
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The Help command causes ed to enter a mode 
in which error messages are printed for all 
subsequent ? diagnostics. It will also explain the 
previous ? if there was one. The H command 
alternately turns this mode on and off; it is 
initially off. 


<text > 


The tnsert command inserts the given text 
before the addressed line; . is left at the last 
inserted line, or, if there were none, at the 
addressed line. This command differs from the 
a command only in the placement of the input 
text. Address 0 is not legal for this command. 
The maximum number of characters that may 
be entered from a terminal is 256 per line 
(including the newline character). 


(.,-+1)j 
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he join command joins contiguous lines by 
removing the appropriate new-line characters. If 
exactly one address is given, this command does 
nothing. 


The mark command marks the addressed line 
with name z, which must be a lower-case letter. 
The address 'z then addresses this line; . is 
unchanged. 


The /ist command prints the addressed lines in 
an unambiguous way: a few  non-printing 
characters (e. ., tab, backspace) are represented 
by (hopefu ly) mnemonic overstrikes, all other 
non-printing characters are printed in octal, and 
long lines are folded. An ! command may be 
appended to any other command other than e, 


f, r, or w. 


(.,.)ma 


(.,.)n 


The move command repositions the addressed 
line(s) after the line addressed by a. Address 0 
is legal for a and causes the addressed line(s) to 
be moved to the beginning of the file; it is an 
error if address a falls within the range of moved 
lines; . is left at the last line moved. 


The number command prints the addressed 
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lines, preceding each line by its line number and 
a tab character; . is left at the last line printed. 
The n command may be appended to any other 
command other than e, f, r, or w. 


The print command prints the addressed lines; . 
is left at the last line printed. The p command 
may be appended to any other command other 
than e, f, r, or w; for example, dp deletes the 
current line and prints the new current line. 


The editor will prompt with a * for all 
subsequent commands. The P command 
alternately turns this mode on and off; it is 
initially off. 


The guit command causes ed to exit. No 
automatic write of a file is done (but see 
DIAGNOSTICS below). 


The editor exits without checking if changes 
have been made in the buffer since the last w 
command. 


($ )r file 


The read command reads in the given file after 
the addressed line. If no file name is given, the 
currently-remembered file name, if any, is used 
(see e and f commands). The currently- 
remembered file name is not changed unless file 
is the very first file name mentioned since ed 
was invoked. Address 0 is legal for r and causes 
the file to be read at the beginning of the buffer. 
If the read is successful, the number of 
characters read is typed; . is set to the last line 
read in. If file is replaced by !, the rest of the 
line is taken to be a shell (sk(1)) command 
whose output is to be read. For example, "$r 
'ls" appends current directory to the end of the 
file being edited. Such a shell command is not 
remembered as the current file name. 


.+ )s/RE/replacement / or 
, ; ‘ Nhe cecil 


The substitute command = searches’ each 
addressed line for an occurrence of the specified 
RE. In each line in which a match is found, all 
(non-overlapped) matched strings are replaced 
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mode, no commands are recognized; all input is merely 
collected. Input mode is left by typing a period (.) alone 
at the beginning of a line. 


Ed supports a limited form of regular ezpression 
notation; regular expressions are used in addresses to 
specify lines and in some commands (e.g., 8) to specify 
portions of a line that are to be substituted. A regular 
expression (RE) specifies a set of character strings. A 
member of this set of strings is said to be matched by 
the RE. The REs allowed by ed are constructed as 
follows: 


The following one-character REs match a_ single 
character: 


1.1. An ordinary character (not one of those discussed 
in 1.2 below) is a one-character RE that matches 
itself. 


1.2 A backslash (\) followed by any special character 
is a one-character RE that matches the special 
character itself. The special characters are: 


a. ., *, [, and 1 Getied, asterisk, left square 
bracket, and backslash, respectively), which 
are always special, except when they appear 
within square brackets ([]; see 1.4 below). 


b. * (caret or circumflex), which is special at the 
beginning of an entire RE (see 3.1 and 3.2 
eel or when it immediately follows the 
left of a pair of square brackets ({]) (see 1.4 
below). 


c. $ (currency symbol), which is special at the 
end of an entire RE (see 3.2 below). 


d. The character used to bound (i.e., delimit) an 
entire RE, which is special for that RE (for 
example, see how slash (/) is used in the g 
command, below. 


1.3 A period (.) is a one-character RE that matches 
any character except new-line. 


1.4 <A non-empty string of characters enclosed in 
square brackets ([]) is a one-character RE that 
matches any one character in that string. If, 
however, the first character of the string is a 
circumflex (*), the one-character RE matches any 
character ezcept new-line and the remaining 
characters in the string. The ~ has this special 
meaning only if it occurs first in the string. The 
minus es may be used to indicate a range of 
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consecutive ASCII characters; for example, [0-9] is 
equivalent to (0123456789]. The — loses this 
special meaning if it occurs first (after an initial ~, 
if any) or last in the string. The right square 
bracket ()) does not terminate such a string when 
it is the first character within it (after an initial ~, 
if any); e.g., []a—f] matches either a right square 
bracket (F or one of the letters a through f 
inclusive. The four characters listed in 1.2.a above 
stand for themselves within such a string of 
characters. 


The following rules may be used to construct REs from 
one-character REs: 


2.1 


2.2 


2.3 


2.4 


2.5 


2.6 


A one-character RE is a RE that matches whatever 
the one-character RE matches. 


A one-character RE followed by an asterisk (*) is a 
RE that matches zero or more occurrences of the 
one-character RE. If there is any choice, the 
longest leftmost string that permits a match is 
chosen. 


A one-character RE followed by \{m\}, \{m,\}, 
or \{m,n\} is a RE that matches a range of 
occurrences of the one-character RE. The values of 
m and n must be non-negative integers less than 
256; \{m\} matches exactly m occurrences; 
\{m,\} matches at least m occurrences; \{ m,n\} 
matches any number of occurrences between m 
and n inclusive. Whenever a choice exists, the RE 
matches as many occurrences as possible. 


The concatenation of REs is a RE that matches the 
concatenation of the strings matched by each 
component of the RE. 


A RE enclosed between the character sequences \( 
and \) is a RE that matches whatever the 
unadorned RE matches. 


The expression \n matches the same string of 
characters as was matched by an_ expression 
enclosed between \{ and \) earlier in the same 
RE. Here n is a digit; the sub-expression specified 
is that beginning with the n-th occurrence of \( 
counting from the left. For example, the 
expression ~*\(.*\)\1$ matches a line consisting of 
two repeated appearances of the same string. 


Finally, an entire RE may be constrained to match only 
an initial segment or final segment of a line (or both): 
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3.1 A circumflex (*) at the beginning of an entire RE 
constrains that RE to match an tntttal segment of 
a line. 


3.2 A currency symbol ($) at the end of an entire RE 
constrains that RE to match a final segment of a 
line. 


The construction *enttre RE$ constrains the entire RE 
to match the entire line. 


The null RE (e.g., //) is equivalent to the last RE 
encountered. See also the last paragraph before FILES 
below. 


To understand addressing in ed it is necessary to know 
that at any time there is a current line. Generally 
speaking, the current line is the last line affected by a 
command; the exact effect on the current line is 
discussed under the description of each command. 
Addresses are constructed as follows: 


1. The character . addresses the current line. 


2. The character $ addresses the last line of the 
buffer. 


3. A decimal number n addresses the n-th line of the 
buffer. 


4. 'z addresses the line marked with the mark name 
character z, which must be a lower-case letter. 
Lines are marked with the k command described 
below. 


5. A RE enclosed by slashes (/) addresses the first 
line found by searching forward from the line 
following the current line toward the end of the 
buffer and stopping at the first line containing a 
string matching the RE. If necessary, the search 
wraps around to the beginning of the buffer and 
continues up to and including the current line, so 
that the entire buffer is searched. See also the last 
paragraph before FILES below. 


6. A RE enclosed in question marks (?) addresses the 
first line found by searching backward from the 
line preceding the current line toward the 
beginning of the buffer and stopping at the first 
line containing a string matching the RE. If 
necessary, the search wraps around to the end of 
the buffer and continues up to and including the 
current line. See also the last paragraph before 
FILES below. 
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7. An address followed by a plus sign (+) or a minus 
sign (—) followed by a decimal number specifies 
that address plus (respectively minus) the indicated 
number of lines. The plus sign may be omitted. 


8. If an address begins with + or ~, the addition or 
subtraction is taken with respect to the current 
line; e.g, —5 is understood to mean .—5. 


9. If an address ends with + or —, then 1 is added to 
or subtracted from the address, respectively. As a 
consequence of this rule and of rule 8 immediately 
above, the address — refers to the line preceding 
the current line. (To maintain compatibility with 
earlier versions of the editor, the character * in 
addresses is entirely equivalent to ~.) Moreover, 
trailing + and — characters have a cumulative 
effect, so —— refers to the current line less 2. 


10. For convenience, a comma (,) stands for the 
address pair 1,$, while a semicolon (;) stands for 
the pair .,$. 


Commands may require zero, one, or two addresses. 
Commands that require no addresses regard the presence 
of an address as an error. Commands that accept one or 
two addresses assume default addresses when an 
insufficient number of addresses is given; if more 
addresses are given than such a command requires, the 
last one(s) are used. 


Typically, addresses are separated from each other by a 
comma a They may also be separated by a semicolon 
(;). In the latter case, the current line (.) is set to the 
first address, and only then is the second address 
calculated. This feature can be used to determine the 
starting line for forward and backward searches (see rules 
5. and 6. above). The second address of any two-address 
sequence must correspond to a line that follows, in the 
buffer, the line corresponding to the first address. 


In the following list of ed commands, the default 
addresses are shown in parentheses. The parentheses are 
not part of the address; they show that the given 
addresses are the default. 


It is generally illegal for more than one command to 
appear on a line. However, any command (except e, f, 
r, or w) may be suffixed by 1, n or p, in which case the 
current line is either listed, numbered or printed, 
respectively, as discussed below under the /, n and p 
commands. 


(.)a 
< text> 
(. Je 
a text > 
(.,-)d 


e file 


E file 


f file 
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The append command reads the given text and 
appends it after the addressed line; . is left at 
the last inserted line, or, if there were none, at 
the addressed line. Address 0 is legal for this 
command: it causes the “appended” text to be 
placed at the beginning of the buffer. The 
maximum number of characters that may be 
entered from a terminal is 256 per line (including 
the newline character). 


The change command deletes the addressed 
lines, then accepts input text that replaces these 
lines; . is left at the last line input, or, if there 
were none, at the first line that was not deleted. 


The delete command deletes the addressed lines 
from the buffer. The line after the last line 
deleted becomes the current line; if the lines 
deleted were originally at the end of the buffer, 
the new last line becomes the current line. 


The edit command causes the entire contents of 
the buffer to be deleted, and then the named file 
to be read in; . is set to the last line of the 
buffer. If no file name is given, the currently- 
remembered file name, if any, is used ieee the f 
command). If % is given in place of a file name, 
the next name on the command line argument 
list is used. The number of characters read is 
typed; file is remembered for possible use as a 
default file name in subsequent ¢, r, and w 
commands. If file is replaced by !, the rest of 
the line is taken to be a shell (sh(1)) command 
whose output is to be read. Such a shell 
command is not remembered as the current file 
name. See also DIAGNOSTICS below. 


The Edit command is like e, except that the 
editor does not check to see if any changes have 
been made to the buffer since the last w 
command. 


If file is given, the filename command changes 
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the currently-remembered file name to file; 
otherwise, it prints the currently-remembered 
file name. 


(1,$ a) He commond list 
n the global command, the first step is to mark 
every line that matches the given RE. Then, for 
every such line, the given command list is 
executed with . initially set to that line. A 
single command or the first of a list of 
commands appears on the same line as the 
global command. All lines of a multi-line list 
except the last line must be ended with a \; a, 
t, and ¢ commands and associated input are 
permitted; the . terminating input mode may be 
omitted if it would be the last line of the 
command list. An empty command Ist is 
equivalent to the p command. The g, G, v, and 
V commands are not permitted in the command 
list. See also BUGS and the last paragraph 
before FILES below. 


(1,$)G/RE/ 

In the interactive Global command, the first 
step is to mark every line that matches the given 
RE. Then, for every such line, that line is 
printed, . is changed to that line, and any one 
command (other than one of the a, ¢, t, g, G, 
v, and V commands) may be input and is 
executed. After the execution of that command, 
the next marked line is printed, and so on; a 
new-line acts as a null command; an & causes 
the re-execution of the most recent command 
executed within the current invocation of G. 
Note that the commands input as part of the 
execution of the G command may address and 
affect any lines in the buffer. The G command 
can be terminated by an interrupt signal (ASCII 
DEL or BREAK). 


The help command gives a short error message 
that explains the reason for the most recent ? 
diagnostic. 
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NAME 


ew, checkew — prepare constant-width text for troff 
SYNOPSIS 
ew [ -lxx ] [ -rxx ] [ -fn] [ -t ] [ +t] [-d] 
| files | 
checkew | -lxx | [ -rxx | files 
DESCRIPTION 


Cw is a preprocessor for troff(1) input files that contain 
text to be typeset in the constant-width (CW) font. 


Text typeset with the CW font resembles the output of 
terminals and of line printers. This font is used to 
typeset examples of programs and of computer output in 
user manuals, programming texts, etc. (An _ earlier 
version of this font was used in typesetting The C 
Programming Language by B. W. Kernighan and D. M 
Ritchie.) It has been designed to be quite distinctive (but 
not overly obtrusive) when used together with the Times 
Roman font. 


Because the CW font contains a ‘‘non-standard” set of 
characters and because text typeset with it requires 
different character and inter-word spacing than is used 
for “standard” fonts, documents that use the CW font 
must be preprocessed by cw. 
The CW font contains the 94 printing ASCII characters: 

abcdefghijkImnopqrstuvwxyz 

ABCDEFGHI JKLMNOPQRSTUVWXYZ 

0123456789 

1$&()°*+@.,/:;=?[][-_-- "< > # 
plus eight non-ASCII characters represented by four- 
character troff(1) names (in some cases attaching these 
names to “non-standard” graphics): 







“Cents” sign 
EBCDIC “not” sign 7 
Left arrow <— 
Right arrow — 
Down arrow | 

Vertical single quote 
Control-shift indicator _¢ 
Visible space indicator a 
Hyphen~ - 


The hyphen is a synonym for the unadorned minus sign 
(-). Certain versions of cw recognize two additional 
names: \(ua for an up arrow and \(lh for a diagonal left- 
up (home) arrow. 
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Cw recognizes five request lines, as well as user-defined 
delimiters. The request lines look like troff(1) macro 
requests, and are copied in their entirety by ew onto its 
output; thus, they can be defined by the user as troff(1) 
macros; in fact, the .CW and .CN macros should be so 
defined (see HINTS below). The five requests are: 


.CW Start of text to be set in the CW font; .CW 
causes a break; it can take precisely the same 
options, in precisely the same format, as are 
available on the cw command line. 


-CN _ End of text to be set in the CW font; .CN causes 
a break; it can take the same options as are 
available on the cw command line. 


-CD Change delimiters and/or settings of other 
options; takes the same options as are available 
on the cw command line. 


-CP argi arg2 arg8 ... argn 
All the arguments (which are delimited like 
troff(1) macro arguments) are concatenated, 
with the odd-numbered arguments set in the CW 
font and the even-numbered ones in the 
prevailing font. 


-PC argl arg2 arg8 ... argn 
Same as .CP, except that the even-numbered 
arguments are set in the CW font and the odd- 
numbered ones in the prevailing font. 


The .CW and .CN requests are meant to bracket text 
(e.g., a program fragment) that is to be typeset in the 
CW font “as is.” Normally, cw operates in the 
transparent mode. In that mode, except for the .CD 
request and the nine special four-character names listed 
in the table above, every character between .CW and 
.CN request lines stands for itself. In particular, cw 
arranges for periods (.) and apostrophes (’) at the 
beginning of lines, and backslashes (\) everywhere to be 
“hidden” from troff(1). The transparent mode can be 
turned off (see below), in which case normal troff(1) rules 
apply; in particular, lines that begin with . and ” are 
passed through untouched (except if they contain 
delimiters—see below). In either case, cw hides the effect 
of the font changes generated by the .CW and .CN 
requests; cw also defeats all ligatures (fi, ff, etc.) in the 
CW font. 


The only purpose of the .CD request is to allow the 
changing of various options other than just at the 
beginning of a document. 


-2- 


CW(1) 


The user can also define delimiters. The left and right 
delimiters perform the same function as the .CW /.CN 
requests; they are meant, however, to enclose CW 
‘“‘words” or “phrases” in running text (see example under 
BUGS below). Cw treats text between delimiters in the 
same manner as text enclosed by .CW /.CN pairs, except 
that, for aesthetic reasons, spaces and backspaces inside 
.CW /.CN pairs have the same width as other CW 
characters, while spaces and _ backspaces between 
delimiters are half as wide, so they have the same width 
as spaces in the prevailing text (but are not adjustable). 
Font changes due to delimiters are not hidden. 


Delimiters have no special meaning inside .CW /.CN 
pairs. 


The options are: 


-lrzr The one- or two-character string zz becomes the 
left delimiter; if zz is omitted, the left delimiter 
becomes undefined, which it is initially. 


-rzz Same for the right delimiter. The left and right 
delimiters may {but need not) be different. 


-fn The CW font is mounted in font position n; 
acceptable values for n are 1, 2, and 3 (default is 
3, replacing the bold font). This option is only 
useful at the beginning of a document. 


-t Turn transparent mode off. 

+t Turn transparent mode on (this is the initial 
default). 

-d Print current option settings on file descriptor 2 


in the form of troff(1) comment lines. This 
option is meant for debugging. 
Cw reads the standard input when no files are specified 
(or when - is specified as the last argument), so it can be 
used as a filter. Typical usage is: 
ew files | troff ... 
Checkew checks that left and right delimiters, as well as 


the .CW /.CN pairs, are properly balanced. It prints out 
all offending lines. 


HINTS 


FILES 
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Typical definitions of the .CW and .CN macros meant to 
be used with the mm(5) macro package: 


.de CW 

DSI 

ps9 

.vs 10.5p 

a 16m/3u 32m/3u 48m/3u 64m/3u 80m/3u 96m/3u ... 
.de CN 

ta 51 11 1.61 2i 2.5) 3i ... 

V8 

.ps 

.DE 


he very least, the .CW macro should invoke the 
‘rofft) no-fill (. nf) mode. 


When set in running text, the CW font is meant to be set 
in the same point size as the rest of the text. In 
displayed matter, on the other hand, it can often be 
profitably set one point smaller than the prevailing point 
size (the displayed definitions of .CW and .CN above are 
one point smaller than the running text on this page). 
The CW font is sized so that, when it is set in 9-point, 
there are 12 characters per inch. 


Documents that contain CW text may also contain tables 
and/or equations. If this is the case, the order of 
preprocessing should be: cw, tbl, and eqn. Usually, the 
tables contained in such documents will not contain any 
CW text, although it is entirely possible to have elements 
of the table set in the CW font; of course, care must be 
taken that tb/(1) format information not be modified by 
cw. Attempts to set equations in the CW font are not 
likely to be either pleasing or successful. 


In the CW font, overstriking is most easily accomplished 
with backspaces: letting <- represent a backspace, d<- 
<-\(dg yields 1 (Because backspaces are half as wide 
between delimiters as inside .CW /.CN pairs—see 
above-—two backspaces are required for each overstrike 
between delimiters.) 


/usr/lib/font/ftCW | CW font-width table 


SEE ALSO 


eqn(1), mmt(1), tbl(1), troff(1), mm(5), mv(5). 


WARNINGS 


If text preprocessed by cw is to make any sense, it must 
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be set on a typesetter equipped with the CW font or on a 
STARE facility; on the latter, the CW font appears as 
bold, but with the proper CW spacing. 


Only a masochist would use periods (.), backslashes (), or 
double quotes (”) as delimiters, or as arguments to .CP 
and .PC. 

Certain CW characters don’t concatenate gracefully with 
certain Times Roman characters, e.g., a CW ampersand 
) followed by a Times Roman comma(,); in such cases, 
udicious use of troff(1) half- and quarter-spaces (\| and 
\) is most salutary, e.g., one should use _&_\*, (rather 
than just plain _&_,) to obtain &, (assuming that _ is 
used for both delimiters). 

Using cw with nroff is silly. 

The output of cw is hard to read. 

See also BUGS under troff(1). 


NAME 
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exref — generate C program cross-reference 


SYNOPSIS 


exref [ options | files 


DESCRIPTION 


Crref analyzes a collection of C files and attempts to 
build a cross-reference table. Cuzref utilizes a special 
version of cpp to include #define’d information in its 
symbol table. It produces a listing on standard output of 
all symbols (auto, static, and global) in each file 
separately, or with the —e option, in combination. Each 
symbol contains an asterisk (*) before the declaring 
reference. 


In addition to the —D, —I and —U options (which are 
identical to their interpretation by cc(1)), the following 
options are interpreted by czref: 


~c¢ Print a combined cross-reference of all input 
files. 
—w<num> 


Width option which formats output no wider 
than <num> (decimal) columns. This option 
will default to 80 if <num> is not specified or 
is less than 51. 


~-o file Direct output to named file. 


—8 Operate silently; does not print input file 
names. 
—t Format listing for 80-column width. 
FILES 
/usr/lib/xepp special version of C-preprocessor. 
SEE ALSO 
ec(1). 
DIAGNOSTICS 


BUGS 


Error messages are unusually cryptic, but usually mean 
that you cannot compile these files, anyway. 


Crref considers a formal argument in a #define macro 
definition to be a declaration of that symbol. For 
example, a program that #includes ctype.h will 
contain many declarations of the variable c. 
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NAME 
date — print and set the date 


SYNOPSIS 
date { mmddhhmmlyy] | | +format | 


MightyFrame Only: 
date [ - | 


DESCRIPTION 
If no argument is given, or if the argument begins with 
+, the current date and time are printed. Otherwise, 
the current date is set. 


The MightyFrame system has a real-time clock that sets 
the current system date. The date — command sets the 
system time to that of the real-time clock. If arguments 
are given, date changes the time on the real-time clock. 


The first mm is the month number; dd is the day 
number in the month; Ah is the hour number (24 hour 
system); the second mm is the minute number; yy is the 
last 2 digits of the year number and is optional. For 
example: 


date 10080045 


sets the date to Oct 8, 12:45 AM. The current year is 
the default if no year is mentioned. The system operates 
in GMT. Date takes care of the conversion to and from 
local standard and daylight time. 


If the argument begins with +, the output of date is 
under the control of the user. The format for the output 
is similar to that of the first argument to printf(3S). All 
output fields are of fixed size (zero padded if necessary). 
Each field descriptor is preceded by % and will be 
replaced in the output by its corresponding value. A 
single % is encoded by %%. All other characters are 
copied to the output without change. The string is 
always terminated with a new-line character. 


Field Descriptors: 

insert a new-line character 
insert a tab character 
month of year ~ 01 to 12 
day of month — OI to 31 
last 2 digits of year — 00 to 99 
date as mm/dd/yy 

hour — 00 to 23 

minute — 00 to 59 

second — 00 to 59 

time as HH:MM:SS 
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day of year — 001 to 366 

day of week — Sunday = 0 
abbreviated weekday — Sun to Sat 
abbreviated month — Jan to Dec 
time in AM/PM notation 


date '+DATE: %m/%d/%y%nTIME: 
%H:%M:%S! 

would have generated as output: 
DATE: 08/01/76 


4 oo zo 


EXAMPLE 


TIME: 14:45:05 
DIAGNOSTICS 
No permission if you are not the super-user and 
you try to change the date; 
bad conversion if the date set is syntactically 
incorrect; 
bad format character if the field descriptor is not 
recognizable. 
SEE ALSO 
printf(3S). 


MightyFrame Administrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 
WARNING 
It is a bad practice to change the date while the system 
is running multi-user. es 
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NAME 

de — desk calculator 
SYNOPSIS 

de | file | 
DESCRIPTION 


De is an arbitrary precision arithmetic package. 
Ordinarily it operates on decimal integers, but one may 
specify an input base, output base, and a number of 
fractional digits to be maintained. (See be({1), a 
preprocessor for de that provides infix notation and a C- - 
like syntax that implements functions. Be also provides 
reasonable control structures for prceane) The overall 
structure of de is a stacking (reverse Polish) calculator. 
If an argument is given, input is taken from that file 
until its end, then from the standard input. The 
following constructions are recognized: 


number 
The value of the number is pushed on the stack. 
A number is an unbroken string of the digits 0-9. 
It may be preceded by an underscore (_) to input 
a negative number. Numbers may contain 
decimal points. 

+-/#%" 
The top two values on the stack are added (+), 
subtracted (—), multiplied (*), divided (/), | 
remaindered (%), or exponentiated (*). The two 
entries are popped off the stack; the result is | 
pushed on the stack in their place. Any fractional 
part of an exponent is ignored. 


sr The top of the stack is popped and stored into a 
register named z, where z may be any character. 
If the s is capitalized, z is treated as a stack and 
the value is pushed on it. 


Iz The value in register z is pushed on the stack. 
The register z is not altered. All registers start 
with zero value. If the 1 is capitalized, register z 
is treated as a stack and its top value is popped 
onto the main stack. 


d The top value on the stack is duplicated. 


Pp The top value on the stack is printed. The top 
value remains unchanged. P interprets the top of 
the stack as an ASCII string, removes it, and 
prints it. 


f All values on the stack are printed. 


— 


see 
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exits the program. If executing a string, the 
recursion level is popped by two. If q is 
capitalized, the top value on the stack is popped 
and the string execution level is popped by that 
value. 


treats the top element of the stack as a character 
string and executes it as a string of de commands. 


replaces the number on the top of the stack with 
its scale factor. 


puts the bracketed ASCII string onto the top of 
the stack. 


>r =r 

The top two elements of the stack are popped and 
compared. Register x is evaluated if they obey 
the stated relation. 


replaces the top element on the stack by its 
square root. Any existing fractional part of the 
argument is taken into account, but otherwise the 
scale factor is ignored. 


interprets the rest of the line as a CTIX system 
command. 


All values on the stack are popped. 


The top value on the stack is popped and used as 
the number radix for further input. I pushes the 
input base on the top of the stack. 


The top value on the stack is popped and used as 
the number radix for further output. 


pushes the output base on the top of the stack. 


the top of the stack is popped, and that value is 
used as a non-negative scale factor: the 
appropriate number of places are printed on 
output, and maintained during multiplication, 
division, and exponentiation. The interaction of 
scale factor, input base, and output base will be 
reasonable if all are changed together. 


The stack level is pushed onto the stack. 


replaces the number on the top of the stack with 
its length. 


A line of input is taken from the input source 
(usually the terminal) and executed. 


are used by bc for array operations. 
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EXAMPLE 
This example prints the first ten values of n!: 


fet deeeplaiteey 
sa 


lyx 
SEE ALSO 
be(1). 
DIAGNOSTICS 
x is unimplemented 
where 2 is an octal number. 
stack empty 
for not enough elements on the stack to do what 
was asked. 
Out of space 
when the free list is exhausted (too many digits). 
Out of headers 
for too many numbers being kept around. 
Out of pushdown 
for too many items on the stack. 
Nesting Depth 
for too many levels of nested execution. 
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NAME 
deopy — copy file systems for optimal access time 


SYNOPSIS 
/ete/dceopy en {-an] [-d] [-v] [-ffsize[zisize]] 
inputfs outputfs 

DESCRIPTION 
Deopy copies file system tnputfs to outputfs. Inputfs is 
the existing file system; outputfs is an appropriately sized 
file system, to hold the reorganized result. For best 
results inputfs should be the raw device and outputfs 
should be the block device. Dcopy should be run on 
unmounted file systems {in the case of the root file 
system, copy to a new slice). With no arguments, deopy 
copies files from inputfs compressing directories by 
removing vacant entries, and spacing consecutive blocks 
in a file by the optimal rotational gap. The possible 
options are 


—sX supply device information for creating an 
optimal organization of blocks in a file. The 
forms of X are the same as the —s option of 
feck(1M). 


—an place the files not accessed in n days after the 
free blocks of the destination file system 
(default for nis 7). If no n is specified then 
no movement occurs. 


-d leave order of directory entries as is (default 
is to move sub-directories to the beginning of 
directories). 

-v currently reports how many files were 


processed, and how big the source and 
destination freelists are. 

—ffeize [sisize | 
specify the outputfe file system and inode list 
sizes (in blocks). If the option (or :isize) is 
ey the values from the tnputfs are 
used. 


Deopy catches interrupts and quits and then reports on 
its progress. To terminate dcopy send a quit signal, and 
dcopy will no longer catch interrupts or quits. 


SEE ALSO 
fsck(1M), mkfs(1M), ps(1). 


DD(1) 


NAME 

dd - convert and copy a file 
SYNOPSIS 

dd {option=value] ... 
DESCRIPTION 


Dd copies the specified input file to the specified output 
with possible conversions. The standard input and 
output are used by default. The input and output block 
size may be specified to take advantage of raw physical 


1/O. 
option values 
if—=file input file name; standard input is 
default 
of=file output file name; standard output is 
default 
ibs—=n input block size n bytes (default 512) 
obs=n output block size (default 512) 
bs=n set both input and output block size, 
superseding ths and obs; also, if no 
conversion is specified, it is 
particularly efficient since no in-core 
copy need be done 
cbs=n conversion buffer size 
skip—=n skip n input blocks before starting 
copy 
seek—=n seek n_ blocks from beginning of 
output file before copying 
count=n copy only n input blocks 
conv=ascii convert EBCDIC to ASCII 
ebedic convert ASCII to EBCDIC 
ibm slightly different map of ASCII to 
EBCDIC 
Icase map alphabetics to lower case 
ucase map alphabetics to upper case 
swab swap every pair of bytes 


noerror do not stop processing on an error 
sync pad every input block to ibs 
++)... several comma-separated conversions 


Where sizes are specified, a number of bytes is expected. 
A number may end with k, b, or w to specify 
multiplication by 1024, 512, or 2, respectively; a pair of 
numbers may be separated by x to indicate a product. 


Cbs is used only if ascii or ebcdic conversion is 
specified. In the former case cbs characters are placed 
into the conversion buffer, converted to ASCII, and 
trailing blanks trimmed and new-line added before 
sending the line to the output. In the latter case ASCII 
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characters are read into the conversion buffer, converted 
to EBCDIC, and blanks added to make up an output 
block of size cbs. 


After completion, dd reports the number of whole and 
partial input and output blocks. 


EXAMPLE 


This command will read an EBCDIC tape blocked ten 
80-byte EBCDIC card images per block into the ASCII file 
x: 
dd if=/dev/rmtO of=x ibs—800 cbs—=80 
conv=ascii,lcase 
Note the use of raw magtape. Dd is especially suited to 
I/O on the raw physical devices because it allows reading 
and writing in arbitrary block sizes. 


SEE ALSO 


cp(1). 


DIAGNOSTICS 


BUGS 


{+p blocks in(out) numbers of full and partial 
blocks read(written) 


The ASCII/EBCDIC conversion tables are taken from the 
256-character standard in the CACM Nov, 1968. The 
ibm conversion, while less blessed as a standard, 
corresponds better to certain IBM print train 
conventions. There is no universal solution. 


New-lines are inserted only on conversion to ASCII; 
padding is done only on conversion to EBCDIC. These 
should be separate options. 
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NAME 
delta - make a delta (change) to an SCCS file 


Seria sip li 1 i r 
elta -r -8 —n —giist —m)mriist 
[~y|comment]] [—p] files . 


DESCRIPTION 
Delta is used to permanently introduce into the named 
SCCS file changes that were made to the file retrieved by 
get(1) (called the g-file, or generated file). 


Delta makes a delta to each named SCCS file. If a 
directory is named, delta behaves as though each file in 
the directory were specified as a named file, except that 
non-SCCS§ files (last component of the path name does 
not begin with s.) and unreadable files are silently 
ignored. If a name of — is given, the standard input is 
read (see WARNINGS); each line of the standard input is 
taken to be the name of an SCCS file to be processed. 


Delta may issue prompts on the standard output 
depending upon certain keyletters specified and flags is 
admin(1 V that may be present in the SCCS file (see —m 
and —y keyletters below). 


Keyletter arguments apply independently to each named 


file. 


—rSID Uniquely identifies which delta is 
to be made to the SCCS file. The 
use of this keyletter is necessary 
only if two or more outstanding 
gets for editing (get —e) on the 
same SCCS file were done by the 
same person (login name). The 
SID value specified with the —r 
keyletter can be either the SID 
specified on the get command line 
or the SID to be made as reported 
by the get command (see qe) 
A diagnostic results if the 
specified SID is ambiguous, or, if 
Necessary and omitted on the 
command line. 


~s Suppresses the issue, on the 
standard output, of the created 
delta’s SID, as well as the number 
of lines inserted, deleted and 
unchanged in the SCCS file. 


—gltst 


—m| mrlist| 


—y|comment| 
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Specifies retention of the edited 
g-file (normally removed at 
completion of delta processing). 


Specifies a list (see gett) for the 
definition of list) of deltas which 
are to be tgnored when the file is 
accessed at the change level (SID) 
created by this delta. 


If the SCCS file has the v flag set 
Gee admin(1)) then a Modification 

equest (MR) number must be 
supplied as the reason for creating 
the new delta. 


If —m is not used and the 
standard input is a terminal, the 
prompt MRs? is issued on the 
standard output before the 
standard input is read; if the 
standard input is not a terminal, 
no prompt is issued. The MRs? 
prompt always precedes the 
comments? prompt (see -y 
keyletter). 


MRs in a list are separated by 
blanks and/or tab characters. An 
unescaped new-line character 
terminates the MR list. 


Note that if the v flag has a value 
(see admin(1)), it is taken to be 
the name of a program (or shell 
procedure) which will validate the 
correctness of the MR numbers. 
If a non-zero exit status is 
returned from MR _ number 
validation program, ‘delta 
terminates (it is assumed that the 
MR numbers were not all valid). 


Arbitrary text used to describe the 
reason for making the delta. A 
null string is considered a valid 
comment. 


If ~y is not specified and the 
standard input is a terminal, the 
prompt comments? is issued on 
the standard output before the 
standard input is read; if the 
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standard input is not a terminal, 
no prompt is_ issued. An 
unescaped new-line character 
terminates the comment text. 


—p Causes delta to print (on the 
standard output) the SCCS file 
differences before and after the 
delta is applied in a diff(1) 
format. 


All files of the form ?-file are explained in the "Source 
Code Control System User’s Guide” in Section 9 of the 
CTIX Programmer’s Guide. The naming convention for 
these files is also described there. 


g-file Existed before the execution of delta; 
removed after completion of delta. 

p-file Existed before the execution of delta; 
may exist after completion of delta. 

q-file Created during the execution of delta; 
removed after completion of delta. 

x-file Created during the execution of delta; 
oe to SCCS file after completion of 
elta, 

z-file Created during the execution of delta; 
removed during the execution of delta. 

d-file Created during the execution of delta; 


removed after completion of delta. 
/usr/bin/bdiff Program to compute differences between 
the “‘gotten”’ file and the g-/ile. 


WARNINGS 


Lines beginning with an SOH ASCII character (binary 
001) cannot be placed in the SCCS file unless the SOH is 
escaped. This character has special meaning to SCCS 
(see sccsfile(4). (5)) and will cause an error. 


A get of many SCCS files, followed by a delta of those 
files, should be avoided when the get generates a large 
amount of data. Instead, multiple get/delta sequences 
should be used. 


If the standard input (—) is specified on the delta 
command line, the —m (if necessary) and —y keyletters 
must also be present. Omission of these keyletters 
causes an error to occur. 


Comments are limited to text strings of at most 512 
characters. 


SEE ALSO 


admin(1), bdiff(1), cde(1), get(1), help(1), _ prs(1), 


23s 


DELTA(1) 


rmdel(1), scesfile(4). 
CTIX Programmer’s Guide, Section 9. 


DIAGNOSTICS 
Use Aelp(1) for explanations. 


NAME 


DEROFF (1) 


deroff — remove nroff/troff, tbl, and eqn constructs 


SYNOPSIS 


deroff {—mx | {-—w] [ files ] 


DESCRIPTION 


Deroff reads each of the files in sequence and removes 
all troff(1) requests, macro calls, backslash constructs, 
egn(1) constructs (between -EQ and .EN lines, and 
between delimiters), and ¢tb/(1) descriptions, perhaps 
replacing them with white space (blanks and blank 
lines), and writes the remainder of the file on the 
standard output. Deroff follows chains of included files 
(.so and .nx troff commands); if a file has already been 
included, a .so naming that file is ignored and a .nx 
naming that file terminates execution. If no input file is 
given, deroff reads the standard input. 


The —m option may be followed by an m, s, orl. The 
—mm option causes the macros be interpreted so that 
only running text is output (i.e., no text from macro 
lines.) The —ml option forces the -mm option and also 
causes deletion of lists associated with the mm macros. 


If the —w option is given, the output is a word list, one 
“word” per line, with all other characters deleted. 
Otherwise, the output follows the original, with the 
deletions mentioned above. In text, a ‘‘word’’ is any 
string that contains at least two letters and is composed 
of letters, digits, ampersands (&), and apostrophes (’)}; in 
a macro call, however, a ‘word’ is a string that begins 
with at least two letters and contains a total of at least 
three letters. Delimiters are any characters other than 
letters, digits, apostrophes, and ampersands. Trailing 
apostrophes and ampersands are removed from ‘“‘words.”’ 


SEE ALSO 


BUGS 


eqn(1), nroff(1), tbl(1), troff(1), spell(1). 


Deroff is not a complete troff interpreter, so it can be 
confused by subtle constructs. Most such errors result in 
too much rather than too little output. 

The —ml option does not handle nested lists correctly. 


DEVNM (1M) 


NAME 

devnm — device name 
SYNOPSIS 

/etc/devnm [names | 
DESCRIPTION 


Devnm identifies the special file associated with the 
mounted file system where the argument name resides. 
(As a special case, both the block device name and the 
swap device name are printed for the argument name / 
if swapping is done on the same disk section as the root 
file system.) Argument names must be full path names. 


This command is most commonly used by / eve le (see 
brc(1M)) to construct a mount table entry for the root 
device. 


EXAMPLE 
The command: 
/etc/devnm /usr 
produces 
dsk/c0d0s3 /usr 
if /usr is mounted on /dev/dsk/c0d0s3. 


FILES faci fase) 
dev /dsk/* 
/etc/mnttab 
SEE ALSO 


bre(1M), setmnt(1M). 


DF(1M) 


NAME 
df — report number of free disk blocks 

SYNOPSIS 
df | -t | ( -f ] [ file-systems | 

DESCRIPTION 
Df prints out the number of free 512-byte blocks and 
free i-nodes available for on-line file systems by 
examining the counts kept in the super-blocks; file- 
systems may be specified either by device name (e.g., 
/dev/dsk/c0d0s1) or by mounted directory name (e.g., 
/usr). If the file-systems argument is unspecified, the 
free space on all of the mounted file systems is printed. 
The —t flag causes the total allocated block figures to be 
reported as well. 
If the —f flag is given, only an actual count of the blocks 
in the free list is made (free i-nodes are not reported). 
With this option, df will report on raw devices. 

FILES /dev /dsk/ 
dev /dsk /* 
/etc/mnttab 

SEE ALSO 


fs(4), mnttab(4). 


NAME 


DIFF (1) 


diff — differential file comparator 


SYNOPSIS 


diff | ~efbhB | filel file2 


DESCRIPTION 


5/86 


Diff tells what lines must be changed in two files to 
bring them into agreement. If filet (file2) is —, the 
standard input is used. If file (ftle2) is a directory, then 
a file in that directory with the name file? (file1) is used. 
The normal output contains lines of these forms: 


nl an3,n4 
ni,n2 dn 
ni,n2 ¢ n8,n4 


These lines resemble ed commands to convert filel into 
file2. The numbers after the letters pertain to file2. In 
fact, by exchanging a for d and reading backward one 
may ascertain equally how to convert file2 into file1. As 
in ed, identical pairs, where nl = n2 or n3 = n4, are 
abbreviated as a single number. 


Following each of these lines come all the lines that are 
affected in the first file flagged by <, then all the lines 
that are affected in the second file flagged by >. 


The —b option causes trailing blanks (spaces and tabs) to 
be ignored and other strings of blanks to compare equal. 


The -—e option produces a script of a, c, and d 
commands for the editor ed, which will recreate file2 
from filet. The ~f option produces a similar script, not 
useful with ed, in the opposite order. In connection with 
—e, the following shell program may help maintain 
multiple versions of a file. Only an ancestral file ($1 
and a chain of version-to-version ed scripts ($2,$3.... 
made by diff need be on hand. A “latest version” 
appears on the standard output. 


(shift; cat $*#; echo '1,$p’)| ed — $1 
Except in rare circumstances, diff finds a smallest 
sufficient set of file differences. 


Option —h does a fast, half-hearted job. It works only 
when changed stretches are short and well separated, but 
does work on files of unlimited length. Options —e and 
—f are unavailable with —h. 


The — B option causes all white space to be ignored. 


DIFF (1) 


FILES 
tmp/d?re?? 
/usr/lib/diffh for —h 
SEE ALSO 
emp(1), comm(1), ed(1). 
DIAGNOSTICS 


Exit status is 0 for no differences, 1 for some differences, 
2 for trouble. 


BUGS 
Editing scripts produced under the —e or —f option are - 
oe about creating lines consisting of a single period 
WARNINGS 
Missing newline at end of file X 
indicates that the last line of file X did not have a 
new-line. If the lines are different, they will be 
flagged and output; although the output will seem 
to indicate they are the same. 


5/86 mee 


NAME 


DIFF3(1) 


diff3 — 3-way differential file comparison 


SYNOPSIS 


diff3 [ —ex3 | filel file2 file3 


DESCRIPTION 


FILES 


Diff? compares three versions of a file, and publishes 
disagreeing ranges of text flagged with these codes: 


== all three files differ 
===] file1 is different 
=== = 2 file2 is different 
=== file is different 


The type of change suffered in converting a given range 
of a given file to some other is indicated in one of these 
ways: 


finla Text is to be appended after 
line number n/ in file f, where 
f =1, 2, or 3. 


finl,n2Ze Text is to be changed in the 
range line nJ to line n2. If n1 
= n2, the range may be 
abbreviated to nJ. 


The original contents of the range follows immediately 
after a c indication. When the contents of two files are 
identical, the contents of the lower-numbered file is 
suppressed. 


Under the —e option, diff? publishes a script for the 
editor ed that will incorporate into file{ all changes 
between file2 and file’, i.e., is changes that normally 
would be flagged ==== and ====3. Option —x 
(-3) produces a script to incorporate only changes 
flagged =—==—= ee) The following command 
will apply the resulting script to file1. 


ed — filel < script 


/tmp/d3* 
Fee aitlSprog 


SEE ALSO 


BUGS 


diff(1). 


Text lines that consist of a single . will defeat —e. 
Files longer than 64K bytes will not work. 


NAME 


DIFFMK (1) 


diffmk — mark differences between files 


SYNOPSIS 


diffmk namel name2 name3 


DESCRIPTION 


Diffmk compares two versions of a file and creates a 
third file that includes “‘change mark’? commands for 
nroff or troff(1). Name and name® are the old and new 
versions of the file. Diffmk generates name3, which 
contains the lines of name? plus inserted formatter 
“change mark” (.mc) requests. When name3 is 
formatted, changed or inserted text is shown by] at the 
right margin of each line. The position of deleted text is 
shown by a single *. 

If anyone is so inclined, diffmk can be used to produce 
listings of C (or other) programs with changes marked. 
A typical command line for such use is: 


diffmk old.c new.c tmp; nroff macs tmp | pr 
where the file macs contains: 
pl 1 
jl 77 
anf 


.€o 
ne 


The .II request might specify a different line length, 
depending on the nature of the program being printed. 
The .eo and .nc requests are probably needed only for C 
programs. 


If the characters | and * are inappropriate, a copy of 
diffmk can be edited to change them (diffmk is a shell 
procedure). 


SEE ALSO 


BUGS 


diff(1), nroff(1), troff(1). 


Aesthetic considerations may dictate manual adjustment 
of some output. File differences involving only 
formatting requests may produce undesirable output, i.e., 
replacing .sp by .sp 2 will produce a ‘“‘change mark’”’ on 
the preceding or following line of output. 


DIRCMP (1) 


NAME 

diremp — directory comparison 
SYNOPSIS 

diremp [ —d | [ -s | | —wn | dirl dir2 
DESCRIPTION 


Diremp examines dirl and dir2 and generates various 
tabulated information about the contents of the 
directories. Listings of files that are unique to each 
directory are generated for all the options. If no option 
is entered, a list is output indicating whether the 
filenames common to both directories have the same 
contents. 


—d Compare the contents of files with the same 
name in both directories and output a list telling 
what must be changed in the two files to bring 
them into agreement. The list format is 


described in diff(1). 
-8 Suppress messages about identical files. 


—wn Change the width of the output line to n 
characters. The default width is 72. 


SEE ALSO 
cmp(1), diff(1). os 


NAME 


DISKUSG ( 1M) 


diskusg - generate disk accounting data by user ID 


SYNOPSIS 


/usr/lib/acct/diskusg [options] [files] 


DESCRIPTION 


Diskusg generates intermediate disk accounting 
information from data in files, or the standard input if 
omitted. Diskusg outputs lines on the standard output, 
one per user, in the following format: 


utd login # blocks 


where 
uid is the numerical user ID of the user. 
login is the login name of the user; and 


#blocks is the total number of 512-byte disk blocks 
allocated to this user. 


Diskusg normally reads only the i-nodes of file systems 
for disk accounting. In this case, files are the special 
filenames of these devices. 


Diskusg recognizes the following options: 


—s the input data is already in diskusg output 
format. Diskusg combines all lines for a 
single user into a single line. 


-v verbose. Print a list on standard error of 
all files that are charged to no one. 


—-i fnmlist ignore the data on those file systems whose 
file system name is in fnmlist. Fnmlist is a 
list of file system names separated by 
commas or enclose within quotes. Diskusg 
compares each name in this list with the 
file system name stored in the volume ID 
(see labelst(1M)). 


—p file use file as the name of the password file to 
generate login names. /etc/passwd is 
used by default. 


—u file write records to file of files that are 
charged to no one. Records consist of the 
special file name, the i-node number, and 
the user ID. 


The output of diskusg is normally the input to acctdisk 
(see acct(1M)) which generates total accounting records 
that can be merged with other accounting records. 
Diskusg is normally run in dodisk (see acctsh(1M)). 


DISKUSG (1M) 


EXAMPLES 


FILES 


The following will generate daily disk accounting 
information: 


for i in s1 s3; do 
diskusg /dev/rdsk/cOd0$i > dtmp.‘basename $i‘ & 
done 
wait 
diskusg -s dtmp.* | sort +On +1 | acctdisk > disktacct 


/etc/passwd used for user ID to login name 
conversions 


SEE ALSO 


acct(1M), acctsh(1M), acct(4) 
MightyFrame Administrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 


DISMOUNT (1) (MiniFrame Only ) 


NAME 

dismount — remove exchangeable disk 
SYNOPSIS 

dismount [ -f | 
DESCRIPTION 


Dismount must be executed before physical removal of 
an exchangeable disk from its drive. For each disk that 
is labeled exchangeable (see  disk(7)), dismount 
syncronizes and unmounts its mounted file systems, 
writes out its volume home block, bars further I/O, and 
clears its “pulled” flag. The last action prevents a 
warning message the next time the disk is placed in the 
drive. 

Once dismount has been run, the exchangeable disk’s 
drive is unusable until the dismounted disk is removed. 
If a MiniFrame has two kinds of exchangeable disks, 
dismount dismounts them both. To restrict dismount to 
one disk, specify —f for floppy. 


FILES 
/etc/mnttab mounted file system list 
/dev/dsk/* disk reserved area 

SEE ALSO 


fsck(1M), update(1), disk(7). 


DU(1) 


NAME 
du — summarize disk usage 

SYNOPSIS 
du [{ —ars | | names | 

DESCRIPTION 
Du gives the number of 512-byte blocks contained in all 
files and (recursively) directories within each directory 
and file specified by the names argument. The block 
count includes the indirect blocks of the file. If names is 
missing, . is used. 
The optional argument —s causes only the grand total 
(for each of the specified names) to be given. The 
optional argument —a causes an entry to be generated 
for each file. Absence of either causes an entry to be 
generated for each directory only. 
Du is normally silent about directories that cannot be 
read, files that cannot be opened, etc. The ~—r option 
will cause du to generate messages in such instances. 
A file with two or more links is only counted once. 

BUGS 


If the ~a option is not used, non-directories given as 
arguments are not listed. 

If there are too many distinct linked files, du will count 
the excess files more than once. 

Files with holes in them will get an incorrect block 
count. 


NAME 


DUMP (1) 


dump — dump selected parts of an object file 


SYNOPSIS 


dump [—acfghlorst| [—s name] files 


DESCRIPTION 


The dump command dumps selected parts of each of its 
object file arguments. 


This command will accept both object files and archives 
of object files. It processes each file argument according 
to one or more of the following options: 


~f 
-o 
—-h 
-s 
-r 
-l 
—t 
-5 name 


—Cc 


Dump the archive header of each 
member of each archive file argument. 


Dump the global symbols in the symbol 
table of an archive. 


Dump each file header. 

Dump each optional header. 
Dump section headers. 

Dump section contents. 

Dump relocation information. 
Dump line number information. 
Dump symbol table entries. 


Dump line number entries for the 
named function. 


Dump the string table. 


The following modifiers are used in conjunction with the 
options listed above to modify their capabilities. 


—d number 


+d number 


—n name 


—-p 
—t index 


Dump the section number or range of 
sections starting at number and ending 
either at the last section number or 
number specified by +d. 


Dump sections in the range either 
beginning with first section or beginning 
with section specified by —d. 


Dump information pertaining only to 
the named entity. This modifier applies 
to —h, —s, —r, —l, and -t. 


Suppress printing of the headers. 


Dump only the indexed symbol table 
entry. The —t used in conjunction with 
+t, specifies a range of symbol table 
entries. 


ae 


DUMP(1) 


+t index Dump the symbol table entries in the 
range ending with the indexed entry. 
The range begins at the first symbol 
table entry or at the entry specified by 
the —t option. 


-u Underline the name of the file for 
emphasis. 
—v Dumps information in — symbolic 


representation rather than numeric 
(e.g., C_STATIC instead of 0X02). This 
modifier can be used with all the above 
options except —s and —o options of 
dump. 


~zZ name,number 
Dump line number entry or range of 
line numbers starting at number for the 
named function. 


+z number Dump line numbers starting at either 
function name or number specified by 
—Z, up to number specified by +z. 


Blanks separating an option and its modifier are ; 
optional. The comma separating the name from the t= 
number modifying the —z option may be replaced by a 
blank. 


The dump command attempts to format the information 
it dumps in a meaningful way, printing certain 
information in character, hex, octal or decimal 
representation as appropriate. 


SEE ALSO 
a.out(4), ar(4). 


~ 


NAME 


ECHO(1) 


echo — echo arguments 


SYNOPSIS 


echo [ arg | ... 


DESCRIPTION 


Echo writes its arguments separated by blanks and 
terminated by a new-line on the standard output. It also 
understands C-like escape conventions; beware of 
conflicts with the shell’s use of \: 


backspace 

print line without new-line 

form-feed 

new-line 

carriage return 

tab 

vertical tab 

backslash 

the 8-bit character whose ASCII code is 
n, an octal number of no more than four 
digits, the first of which must be zero. 


Echo is useful for producing diagnostics in command 
files and for sending known data into a pipe. 


SEE ALSO 
sh(1). 


ED(1) 


NAME 

ed, red — text editor 
SYNOPSIS 

ed { — | [ file} ... 

red | — | [ file ] ... 
DESCRIPTION 


Ed is the standard text editor. If the file argument is 
given, ed simulates an e command (see below) on the 
named file; that is to say, the file is read into ed’s buffer 
so that it can be edited. If multiple file arguments are 
given, the % argument of the e command becomes 
useful. The optional — suppresses the printing of 
character counts by e, r, and w commands, of 
diagnostics from e and g commands, and of the ! prompt 
after a !shell command. Ed operates on a copy of the 
file it is editing; changes made to the copy have no effect 
on the file until a w (write) command is given. The 
copy of the text being edited resides in a temporary file 
called the buffer. There is only one buffer. 


Red is a restricted version of ed. It will only allow 
editing of files in the current directory. It prohibits 
executing shell commands via !shell command. Attempts 
to bypass these restrictions result in an error message 
(restricted shell). 


Both ed and red support the fspec(4) formatting 
capability. After including a format specification as the 
first line of file and invoking ed with your terminal in 
stty —tabs or stty tab3 mode (see stty(1), the specified 
tab stops will automatically be used when scanning file. 
For example, if the first line of a file contained: 
<:t5,10,15 s72:> 

tab stops would be set at columns 5, 10 and 15, and a 
maximum line length of 72 would be imposed. NOTE: 
while inputting text, tab characters when typed are 
expanded to every eighth column as is the default. 


Commands to ed have a simple and regular structure: 
zero, one, or two addresses followed by a single- 
character command, possibly followed by parameters to 
that command. These addresses specify one or more 
lines in the buffer. Every command that requires 
addresses has default addresses, so that the addresses can 
very often be omitted. 


In general, only one command may appear on a line. 
Certain commands allow the input of text. This text is 
placed in the appropriate place in the buffer. While ed 
is accepting text, it is said to be in tnput mode. In this 


sors 


EQN(1) 


over: a over b yields +3 sqrt makes square roots: 
1 


1 over sqrt {az sup 2+bz+c} results in ———————— 
Vaz?+bz +e 


The keywords from and to introduce lower and upper 

limits: lim 2; is made with 
Rn—-0O 

lim from {n -> inf} sum from 0 ton zx subt. Left 

and right brackets, braces, etc., of the right height are 

made with left and right: 


left [x sup 2+ y sup 2 over alpha right |] ~=~ 1 
produces 
2 
22 = 1. 
a 


Legal characters after left and right are braces, 
brackets, bars, ¢ and f for ceiling and floor, and "” for 
nothing at all (useful for a right-side-only bracket). A 
left thing need not have a matching right thing. 


Vertical piles of things are made with pile, Ipile, cpile, 
and rpile: 

pile {a above b above c} 

produces 

a 


b. 


c 

Piles may have arbitrary numbers of elements; Ipile 
left-justifies, pile and cpile center (but with different 
vertical spacing), and rpile right justifies. Matrices are 
made with matrix: 


matrix { lcol { x sub ¢ above y sub 2} ccol { 1 
above 2} } 

produces 
zy; 1 


Yo 2 
In addition, there is rcol for a right-justified column. 


Diacritical marks are made with dot, dotdot, hat, 
tilde, bar, vec, dyad, and under: z dot = f(t) bar is 
z=f(t), y dotdot bar ~=~ n under is ¥ =n, and 
zvec ~=~ y dyadis? = ¥. 

Point sizes and fonts can be changed with size n or size 
+n, roman, italic, bold, and font n. Point sizes and 
fonts can be changed globally in a document by gsize n 
and gfont n, or by the command-line arguments —sn 
and —fn. 


EQN(1) 


Normally, subscripts and superscripts are reduced by 3 
points from the previous size; this may be changed by 
the command-line argument —pn. 


Successive display arguments can be lined up. Place 
mark before the desired lineup point in the first 
equation; place lineup at the place that is to line up 
vertically in subsequent equations. 


Shorthands may be defined or existing keywords 
redefined with define: 


define thing % replacement % 


defines a new token called thing that will be replaced by 
replacement whenever it appears thereafter. The % 
may be any character that does not occur in 
replacement. 


Keywords such as sum sya at ), inf (oo), and 
shorthands such as >= (> ; ee > (—) are 
recognized. Greek letters are nal si out in the desired 
case, as in alpha (a), or GAMMA (I). Mathematical 
words such as sin, cos, and log are made Roman 
automatically. meet four-character escapes such as 
\(dd (¢) and \(bs (@) may be used anywhere. Strings 
enclosed in double quotes ("...”) are passed through 
untouched; this permits keywords to be entered as text, 
and can be used to communicate with troff(1) when all 
else fails. Full details are given in the manual cited 
below. 


SEE ALSO 


BUGS 


ew(1), mm(1),  mmt(1),  nroff(1),  tbi(1), — troff(1), 
Atha 5), Ae amy 0) M) 


To embolden digits, parentheses, etc., it is necessary to 
quote them, as in bold 712.3”. 
See also BUGS under troff(1). 


ENV(1) 


NAME 

env — set environment for command execution 
SYNOPSIS 

env [—] [ name=value | .... [ command args | 
DESCRIPTION 


Env obtains the current environment, modifies it 
according to its arguments, then executes the command 
with the modified environment. Arguments of the form 
name=value are merged into the inherited environment 
before the command is executed. The — flag causes the 
inherited environment to be ignored completely, so that 
the command is executed with exactly the environment 
specified by the arguments. 


If no command is specified, the resulting environment is 
printed, one name-value pair per line. 


SEE ALSO 
sh(1), exec(2), profile(4), environ(5). 


EQN(1) 


NAME 
eqn, neqn, checkeq — format mathematical text for nroff 
or troff 

SYNOPSIS 
eqn { —dxy | [ —pn | [ ~sn | [ —fn ] [ files ] 
neqn { —dxy | [ —pn ] { —sn | { —-fn | | files ] 
checkeq | files | 

DESCRIPTION 


Eqn is a_ troff(1) preprocessor for typesetting 
mathematical text on a phototypesetter, while negn is 
used for the same purpose with nroff on typewriter-like 
terminals. Usage is almost always: 


eqn files | troff 
neqn files | nroff 


or equivalent. 


If no files are specified (or if — is specified as the last 
argument), these programs read the standard input. A 
line beginning with .EQ marks the start of an equation; 
the end of an equation is marked by a line beginning 
with .EN. Neither of these lines is altered, so they may 
be defined in macro packages to get centering, 
numbering, etc. It is also possible to designate two 
characters as delimiters; subsequent text between 
delimiters is then treated as egn input. Delimiters may 
be set to characters z and y with the command-line 
argument —dzy or (more commonly) with delim zy 
between .EQ and .EN. The left and right delimiters 
may be the same character; the dollar sign is often used 
as such a delimiter. Delimiters are turned off by delim 
off. All text that is neither between delimiters nor 
between .EQ and .EN is passed through untouched. 


The program checkeg reports missing or unbalanced 
delimiters and .EQ/.EN pairs. 


Tokens within egn are separated by spaces, tabs, new- 
lines, braces, double quotes, tildes, and circumflexes. 
Braces {} are used for grouping; generally speaking, 
anywhere a single character such as z could appear, a 
complicated construction enclosed in braces may be used 
instead. Tilde (~) represents a full space in the output, 
circumflex (*) half as much. 


Subscripts and superscripts are produced with the 
keywords sub and sup. Thus 2 gub makes 2;, 
a sub k sup 2 produces a,”, while ¢? +” is made with 
e sup {4 sup 2 + y sup 2}. Fractions are made with 


NAME 


ERRDEAD (1M) 


errdead — extract error records and status information 
from dump 


SYNOPSIS 


/ete/errdead [-ale][f]] [ dumpfile | { namelist ] 


DESCRIPTION 


FILES 


When hardware errors are detected by the system, an 
error record that contains information pertinent to the 
error jis generated. If the  error-logging demon 
errdemon(1M) is not active or if the system crashes 
before the record can be placed in the error file, the error 
information is held by the system in a local buffer. 
errdead examines a system dump (or memory), extracts 
such error records, and passes them to errpt(1M) for 
analysis. 


Errdead understands the following options: 


-a Instead of passing extracted records to 
errpt(1M), append them to /usr/adm/errfile, 
provided that the dump corresponds to the 
namelist and that the dump is newer than the 
error file. 


-e Only valid if ~—a is also specified. Invoke 
errdemon(1M) when done. This is normally 
done in the re script (see 6re(1M)). 


-f Only valid if -—a is also specified. Write 
extracted records even if the dump is older than 
the error file. 


The dumpfile specifies the file (or memory) that is to be 
examined; if not given, errdead looks for a dump area by 
scanning the available disks in the same order as does 
the bootstrap ROM. The system namelist is specified by 
namelist; if not given, /unix is used. 


/unix system namelist 
/usr/bin/errpt analysis program 
/usr/tmp/errXXXXXX temporary file 
/usr/adm/errfile repository for error records 
/etc/log/confile console file 


DIAGNOSTICS 


Diagnostics may come from either errdead or errpt. In 
either case, they are intended to be self-explanatory. 


SEE ALSO 


errdemon(1M), errpt(1M). 


ERRDEMON (1M) 


NAME 

errdemon — error-logging demon 
SYNOPSIS 

/usr/lib/errdemon [ -n | [ -c file | [ file | 
DESCRIPTION 


FILES 


The error logging demon errdemon collects error records 
from the operating system by reading the special file 
/dev/error and places them in file. If file is not 
specified when the demon is activated, 
]ias/accd/ecchls is used. Note that file is created if it 
does not exist; otherwise, error records are appended to 
it, so that no previous error data is lost. No analysis of 
the error records is done by errdemon; that responsibility 
is left to errpt(1M). Errdemon can also extract console 
records; the —n option disables this, thus forcing all 
console reports to stay in a circular buffer in the kernel. 
The —e option allows specifying a console file. The 
default console file is Jete)lon /eonflle The error- 
logging demon is terminated by sending it a software kill 
signal (see &rll(1)). Only the superuser may start the 
demon, and only one demon may be active at any time. 


/dev/error source of error records 
/usr/adm/errfile repository for error records 
/etc/log/confile console records 
/dev/console 


DIAGNOSTICS 


The diagnostics produced by errdemon are intended to 
be self-explanatory. 


SEE ALSO 


errpt(1M), errstop(1M), kill(1), err(7). 


ERRPT (1M) 


NAME 

errpt — process a report of logged errors 
SYNOPSIS 

errpt [ options | | files | 
DESCRIPTION 


Errpt processes data collected by the error logging 
mechanism (errdemon(1M)) and generates a report of 
that data. The default report is a summary of all errors 
posted in the files named. Options apply to all files and 
are described below. If no files are specified, errpt 
attempts to use /usr/adm/errfile as file. 


A summary report notes the options that may limit its 
completeness, records the time stamped on the earliest 
and latest errors encountered, and gives the total number 
of errors of one or more types. Each device summary 
contains the total number of unrecovered errors, 
recovered errors, errors unabled to be logged, I/O 
operations on the device, and miscellaneous activities 
that occurred on the device. The number of times that 
errpt has difficulty reading input data is included as 
read errors. 


Any detailed report contains, in addition to specific error 
information, all instances of the error logging process 
being started and stopped, and any time changes (via 
date(1)) that took place during the interval being 
processed. A summary of each error type included in the 
report is appended to a detailed report. 


A report may be limited to certain records in the 
following ways: 


—s date Ignore all records posted earlier than 
date, where date has the form 
mmddhhmmyy, consistent in meaning 
with the date(1) command. 


—e date Ignore all records posted later than 
date, whose form is as_ described 
above. 

—a Produce a detailed report that includes 
all error types. 

—d devlist A detailed report is limited to data 


about devices given in devlist, where 
devlist can be one of two forms: a list 
of device identifiers separated from 
one another by a comma, or a list of 
device identifiers enclosed in double 
quotes and separated from one another 


ee 


es 
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by a comma and/or more spaces. 
Errpt is familiar with the block 
devices GD? (0 to 15). Additional 
identifiers are int, mem, QICO for 
1/4-inch tape, and TPO for 1/2-inch 
tape, which include detailed reports of 
stray-interrupt, and tty and _ serial 
asynchronous terminals memory-parity 
type errors, respectively. 


Limit the size of a detailed report to n 
pages. 
In a detailed report, limit the reporting 


of block device errors to unrecovered 
errors. 


Logical blocks in the filesystem are 1024 bytes. Physical 
sector numbers are 512-byte blocks. 


FILES 
/usr/adm/errfile 


SEE ALSO 


default error file 


date(1), errdead(1M), errdemon(1M), errfile(4). 


ERRSTOP (1M) 


NAME 

errstop — terminate the error-logging demon 
SYNOPSIS 

/etc/errstop | namelist } 
DESCRIPTION 


The error-logging demon errdemon(1M) is terminated by 

using errstop. This is accomplished by executing ps(1) 

to determine the demon’s identity and then sending it a 

software kill signal (see signal(2)); /unix is used as the 

system namelist if none is specified. Only the super-user - 
may use errstop. 


FILES 
/unix _— default system namelist 


DIAGNOSTICS 
The diagnostics produced by errstop are intended to be 
self-explanatory. 


SEE ALSO 
errdemon(1M), ps(1), kill(2). signal(2). 


EX(1) 


NAME 
ex ~— text editor 

SYNOPSIS 
ex [| - ] [ -v_] | -t tog ] | -r |] [ -R ] 
[ +command | | -1] name ... 

DESCRIPTION 


Ex is the root of a family of editors: ez and ut. Ex is a 
superset of ed, with the most notable extension being a 
display editing facility. Display based editing is the 
focus of vt. 


If you have a CRT terminal, you may wish to use a 
display based editor; in this case see vt(1), which is a 
command which focuses on the display editing portion of 
ex. 


FOR ED USERS 

If you have used ed you will find that ex has a number 
of new features useful on CRT terminals. Intelligent 
terminals and high speed terminals are very pleasant to 
use with vt. Generally, the editor uses far more of the 
capabilities of terminals than ed does, and uses the 
terminal capability data base terminfo(4) and the type of 
the terminal you are using from the variable TERM in 
the environment to determine how to drive your 
terminal efficiently. The editor makes use of features 
such as insert and delete character and line in its visual 
command (which can be abbreviated vi) and which is the 
central mode of editing when using vt (1). 


Ex contains a number of new features for easily viewing 
the text of the file. The s command gives easy access to 
windows of text. Hitting “D causes the editor to scroll a 
half-window of text and is more useful for quickly 
stepping through a file than just hitting return. Of 
course, the screen-oriented visual mode gives constant 
access to editing context. 


Ex gives you more help when you make mistakes. The 
undo (u) command allows you to reverse any single 
change which goes astray. Ez gives you a lot of 
feedback, normally printing changed lines, and indicates 
when more than a few lines are affected by a command 
so that it is easy to detect when a command has affected 
more lines than it should have. 


The editor also normally prevents overwriting existing 
files unless you edited them so that you do not 
accidentally clobber with a write a file other than the 
one you are editing. If the system (or editor) crashes, or 
you accidentally hang up the phone, you can use the 


he 
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editor recover command to retrieve your work. This 
will get you back to within a few lines of where you left 
off. 


Ex has several features for dealing with more than one 
file at a time. You can give it a list of files on the 
command line and use the next (n) command to deal 
with each in turn. The next command can also be given 
a list of filenames, or a pattern as used by the shell to 
specify a new set of files to be dealt with. In general, 
filenames in the editor may be formed with full shell 
metasyntax. The metacharacter ‘%’ is also available in 
forming filenames and is replaced by the name of the 
current file. 


For moving text between files and within a file the editor 
has a group of buffers, named a through z. You can 
place text in these named buffers and carry it over when 
you edit another file. 


There is a command & in ez which repeats the last 
substitute command. In addition there is a confirmed 
substitute command. You give a range of substitutions 
to be done and the editor interactively asks whether each 
substitution is desired. 


It is possible to ignore case of letters in searches and 
substitutions. Ez also allows regular expressions which 
match words to be constructed. This is convenient, for 
example, in searching for the word ‘edit’ if your 
document also contains the word “editor.” 


Ex has a set of opttons which you can set to tailor it to 
your liking. One option which is very useful is the 
autotndent option which allows the editor to 
automatically supply leading white space to align text. 
You can then use the “D key as a backtab and space and 
tab forward to align new code easily. 


Miscellaneous new useful features include an intelligent 
join (3) command which supplies white space between 
joined lines automatically, commands < and > which 
shift groups of lines, and the ability to filter portions of 
the buffer through commands such as sort. 


INVOCATION OPTIONS 
The following invocation options are interpreted by ez: 


- Suppress all interactive-user feedback. 
This is useful in processing editor 
scripts. 


-~v Invokes vt. 


—t tagfR 


—r file 


-R 


+command 


-| 
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Edit the file containing the tag and 
position the editor at its definition. 


Recover file after an editor or system 
crash. If file is not specified a list of all 
saved files will be printed. 


Readonly mode set, prevents 
accidentally overwriting the file. 

Begin editing by executing the specified 
editor search or positioning command. 
LISP mode; indents appropriately for 
lisp code, the Q [[ and ]] commands 
in vt? are modi to ea meaning for 
lisp. 


The name argument indicates files to be edited. 


Normal and _ initial state. Input 
prompted for by :. Your kill character 
cancels partial command. 


Entered by a i and ec. Arbitrary text 
may be entered. Insert is normally 
terminated by line having only . on it, 
or abnormally with an interrupt. 


Entered by vi, terminates with Q or “\. 


next n unabbrev una 
number nu undo u 
unmap unm 
preserve pre version ve 
print p visual vi 
put pu write w 
quit q xit x 
read re yank ya 
recover rec window x 
rewind rew escape ! 
set se Ishift < 
shell sh print next CR 
source so resubst & 
stop st rshift > 
substitute 8 scroll ‘D 


/pat next with pat 
?pat previous with pat 


Ex States 
Command 
Insert 
Visual 

Ex command names and abbreviations 
abbrev ab 
append a 
args ar 
change c 
copy co 
delete d 
edit e 
file f 
global g 
insert i 
join j 
list 1 
map 
mark ma 
move m 

Ex Command Addresses 
n line n 
% current 
$ last 
+ next 
- previous 


mn n before x 
Iyy z through y 
’t marked with z 


ae 
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+n n forward v8 previous context 
% 1,$ 

Initializing options 
EXINIT place set’s here in environment var. 
$HOME/.exre editor initialization file 
./.exre editor initialization file 
set z enable option 
set noz disable option 
set z= val give value val 
set show changed options 
set all show all options 
set 2? show value of option z 

Most useful options 
autoindent ai supply indent 
autowrite aw write before changing files 
ignorecase ic in scanning 
lisp () { } are s-exp’s 
list print “I for tab, $ at end 
magic - [ * special in patterns 
number nu number lines 
paragraphs para macro names which start ... 
redraw simulate smart terminal 
scroll command mode lines 
sections sect macro names ... 
shiftwidth sw for < >, and input *“D 
showmatch sm to ) and } as typed 
showmode smd show insert mode in vt 
slowopen slow stop updates during insert 
window visual mode lines 
wrapscan ws around end of buffer? 
wrapmargin wm automatic line splitting 


Scanning pattern formation 
- beginning of line 


$ end of line 

. any character 

\< beginning of word 
\> end of word 

str] any char in sér 
Tetr ... not in str 

z-y ... between z and y 


any number of preceding 


AUTHOR 
Vi and ez are based on software developed by The 
University of California, Berkeley, California, Computer 
Science Division, Department of Electrical Engineering 
and Computer Science. 
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FILES 
/usr/lib/ex?.?strings error messages 
/usr/lib/ex?.?recover recover command 
/usr/lib/ex?.?preserve preserve command 
/usr/lib/terminfo describes capabilities of 
terminals 
$HOME/.exre editor startup file 
./ .eXre editor startup file 
tmp/Exnnnnn editor temporary 
/tmp/Rxnnnnn named buffer temporary 
/usr/ preserve preservation directory 
SEE ALSO 


awk(1), ed(1), edit(1), grep(1), sed(1), vi(1), curses(3X), 
term(4), terminfo(4). 
CTIX Programmer's Guide. 


CAVEATS AND BUGS 


The undo command causes all marks to be lost on lines 
changed and then restored if the marked lines were 
changed. 


Undo never clears the buffer modified condition. 


The z command prints a number of logical rather than 
physical lines. More than a screen full of output may 
result if long lines are present. 


File input/output errors do not print a name if the 
command line ‘—’ option is used. 


There is no easy way to do a single scan ignoring case. 


The editor does not warn if text is placed in named 
buffers and not used before exiting the editor. 


Null characters are discarded in input files and cannot 
appear in resultant files. 


Due to export restrictions, encryption features are not 
available. 


NAME 


EXPAND (1) 


expand, unexpand — expand tabs to spaces, and vice 
versa 


SYNOPSIS 


expand [{ —tabstop ] | -tabl,tab2,...,tabn } [ file... ] 
unexpand [ —a | { file .. | 


DESCRIPTION 


Expand processes the named files or the standard input 
writing the standard output with tabs changed into 
blanks. Backspace characters are preserved into the 
output and decrement the column count for tab 
calculations. Expand is useful for pre-processing 
character files (before sorting, looking at specific 
columns, etc.) that contain tabs. 


If a single tabstop argument is given then tabs are set 
tabstop spaces apart instead of the default 8. If multiple 
tabstops are given then the tabs are set at those specific 
columns. 


Unezpand puts tabs back into the data from the 
standard input or the named files and writes the result 
on the standard output. By default only leading blanks 
and tabs are reconverted to maximal strings of tabs. If 
the —a option is given, then tabs are inserted whenever 
they would compress the resultant file by replacing two 
or more characters. 


SEE ALSO 


5/86 


newform(1). 


NAME 


EXPR (1) 


expr — evaluate arguments as an expression 


SYNOPSIS 


expr arguments 


DESCRIPTION 


The arguments are taken as an expression. After 
evaluation, the result is written on the standard output. 
Terms of the expression must be separated by blanks. 
Characters special to the shell must be escaped. Note 
that O is returned to indicate a zero value, rather than 
the null string. Strings containing blanks or other 
special characters should be quoted. Integer-valued 
arguments may be preceded by a unary minus sign. 
Internally, integers are treated as 32-bit, 2s complement 
numbers. 


The operators and keywords are _ listed below. 
Characters that need to be escaped are preceded by \. 
The list is in order of increasing precedence, with equal 
precedence operators grouped within { } symbols. 


expr \{ expr 
returns the first expr if it is neither null nor 0, 
otherwise returns the second ezpr. 

expr \& expr 
returns the first expr if neither ezpr is null or 0, 
otherwise returns Q. 


eapr { =, \>, \>=, \<, \<=, != } expr 
returns the result of an integer comparison if 
both arguments are integers, otherwise returns 
the result of a lexical comparison. 

expr { +, — } expr 
addition or subtraction of  integer-valued 
arguments. 


expr { \*, /, % } expr 
multiplication, division, or remainder of the 
integer-valued arguments. 


expr: expr 
The matching operator : compares the first 
argument with the second argument which must 
be a regular expression. Regular expression 
syntax is the same as that of ed(1), except that 
all patterns are “‘anchored”’ (i.e., begin with *) 
and, therefore, ~ is not a special character, in 
that context. Normally, the matching operator 
returns the number of characters matched (0 on 
failure). Alternatively, the \(...\) pattern 


ie 


EXPR (1) 


symbols can be used to return a portion of the 
first argument. 


EXAMPLES 
1. a= ‘expr $a + 1° 
adds 1 to the shell variable a. 
2. # For $a equal to either ”/usr/abc/file” or 
just “file” ” 
expr $a: *.*/\(.*\)* \| $a 
returns the last segment of a path name 
(i.e., file). Watch out for / alone as an 
argument: ezpr will take it as the 
division operator (see BUGS below). 
3. # A better representation of example 2. 
expr //$a + 7.*/\(.*\)7 
The addition of the // characters 
eliminates any ambiguity about the 
division operator and simplifies the 
whole expression. 
4. expr $VAR : 7.*7 
returns the number of characters in 
$VAR. 
SEE ALSO 
ed(1), sh(1). 
EXIT CODE 


As a side effect of expression evaluation, expr returns the 
following exit values: 


0 if the expression is neither null nor 0 
1 if the expression ts null or O 
2 for invalid expressions. 
DIAGNOSTICS 
syntax error for operator/operand errors 


non-numeric argument if arithmetic is attempted on 
such a string 


BUGS 
After argument processing by the shell, expr cannot tell 
the difference between an operator and an operand 


except by the value. If $a is an =, the command: 
expr $2 = ’=” 

looks like: 
expr = = = 


EXPR (1) 


as the arguments are passed to ezpr (and they will all be 
taken as the = operator). The following works: 


expr X$a = X= 


FACTOR(1) 


NAME 

factor — factor a number 
SYNOPSIS 

factor | number ] 
DESCRIPTION 


When factor is invoked without an argument, it waits 

for a number to be typed in. If you type in a positive 

number less than 2° about 7.2X10"° ) it will factor the 

number and print its prime factors; each one is printed 

the proper number of times. Then it waits for another - 
number. It exits if it encounters a zero or any non- 

numeric character. 


If factor is invoked with an argument, it factors the 
number as above and then exits. 


Maximum time to factor is proportional to /n and 
occurs when n is prime or the square of a prime. 


DIAGNOSTICS 
“Ouch” for input out of range or for garbage input. 


FF (1M) 


NAME 
ff — list file names and statistics for a file system 


SYNOPSIS 
/ete/ff {options} special 

DESCRIPTION 
Ff reads the i-list and directories of the special file, 
assuming it to be a file system, saving i-node data for 
files which match the selection criteria. Output consists 
of the path name for each saved i-node, plus any other 
file information requested using the print options below. 
Output fields are positional. The output is produced in 
i-node order; fields are separated by tabs. The default 
line produced by ff is: 


path-name i-number 
With all opttons enabled, output fields would be: 
path-name i-number size uid 


The argument n in the option descriptions that follow is 
used as a decimal integer (optionally signed), where +n 
means more than n, —n means less than n, and n means 
exactly n. A day is defined as a 24 hour period. 


—I Do not print the i-node number after each 
path name. 
-l Generate a supplementary list of all path 


names for multiply linked files. 


—p prefix The specified prefix will be added to each 
generated path name. The default is .. 


-8 Print the file size, in bytes, after each 
path name. 

-—u Print the owner’s login name after each 
path name. 

-—an Select if the i-node has been accessed in n 
days. 

—m n Select if the i-node has been modified in n 
days. 

-cn Select if the i-node has been changed in n 
days. 

—n file Select if the i-node has been modified 


more recently than the argument file. 


-i t-node-list Generate names for only those i-nodes 
specified in t-node-list. 


EXAMPLES 
To generate a list of the names of all files on a specified 


-1- 
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file system: 


ff -I /dev/rdsk/c0d0s1 
To produce an index of files and i-numbers which are on 
a file system and have been modified in the last 24 
hours: 
ff —m -1 /dev/cOd0sl > /log/incbackup/usr/tuesday 
To obtain the path names for i-nodes 451 and 76 on a 
specified file system: 


ff -i 451,76 /dev/rdsk/cOd1s3 


SEE ALSO 


BUGS 


finc(1M), find(1), frec(1M), ncheck(1M). 


Only a single path name out of any possible ones will be 
generated for a multiply linked i-node, unless the —1 
option is specified. When -—I is specified, no selection 
criteria apply to the names generated. All possible 
names for every linked file on the file system will be 
included in the output. 


On very large file systems, memory may run out before 
ff does. 


FILE(1) 


NAME 

file — determine file type 
SYNOPSIS 

file { -c ] [ -f ffile | [ —m mfile | arg ... 
DESCRIPTION 


File performs a series of tests on each argument in an 
attempt to classify it. If an argument appears to be 
ASCII, file examines the first 512 bytes and tries to guess 
its language. If an argument is an executable a.out, file 
will print the version stamp, provided it is greater than 0 


(see ld(1)). 


If the —f option is given, the next argument is taken to 
be a file containing the names of the files to be 
examined. 


File uses the file /ete/magic to identify files that have 
some sort of magic number, that is, any file containing a 
numeric or string constant that indicates its type. 
Commentary at the beginning of /etc/magic explains 
its format. 


The —m option instructs file to use an alternate magic 
file. 

The —c flag causes file to check the magic file for format 
errors. This validation is not normally carried out for 
reasons of efficiency. No file typing is done under —c. 


SEE ALSO 
ar(1), 1d(1). 


NAME 


FINC(1M) 


fine — fast incremental backup 


SYNOPSIS 


fine [selection-criteria] file-system raw-tape 


DESCRIPTION 


Fine selectively copies the input fitle-system to the 
output raw-tape. The cautious will want to mount the 
input file-system read-only to insure an accurate backup, 
although acceptable results can be obtained in read-write 
mode. The tape must be previously labelled by labelit 
(see voleopy(1M)). The selection is controlled by the 
selection-criteria, accepting only those i-nodes/files for 
whom the conditions are true. 


It is recommended that production of a fine tape be 
preceded by the ff command, and the output of ff be 
saved as an index of the tape’s contents. Files on a finc 
tape may be recovered with the frec command. 


The argument n in the selectton-criterta which follow is 
used as a decimal integer (optionally signed), where +n 
means more than n, —n means less than n, and n means 
exactly n. A day is defined as a 24 hours. 


~an True if the file has been accessed in n 
days. 

—mn True if the file has been modified in n 
days. 

-cen True if the i-node has been changed in 
n days. 


—n file True for any file which has been 
modified more recently than the 
argument file. 


EXAMPLES 


To write a tape consisting of all files from file-system 
/usr modified in the last 48 hours: 


fine -m ~2 /dev/dsk/c0d0s1 /dev/rmt0 


SEE ALSO 


cpio(1), ff{(1M), frec(1M), volcopy(1M). 


NAME 


find — find files 


SYNOPSIS 


FIND (1) 


find path-name-list expression 


DESCRIPTION 


Find recursively descends the directory hierarchy for 
each path name in the path-name-list (i.e., one or more 


path names) 


seeking files that match a boolean 


expression written in the primaries given below. In the 
descriptions, the argument n is used as a decimal integer 
where +n means more than n, —n means less than n 
and n means exactly n. 


—name file 


—perm onum 


—type c 


—links n 


—user uname 


—group gname 


—size n(c] 


—atime n 


True if file matches the current file 
name. Normal shell argument syntax 


may be used if escaped (watch out for 
[, ? and *), 


True if the file permission flags exactly 
match the octal number onum (see 
chmod(1)). If onum is prefixed by a 
minus sign, more flag bits (017777, see 
stat(2)) become significant and the 
flags are compared. 


True if the type of the file is c, where 
c is b, ec, d, p, or f for block special 
file, character special file, directory, 
fifo (a.k.a. named pipe), or plain file, 
respectively. 


True if the file has n links. 


True if the file belongs to the user 
uname. If uname is numeric and does 
not appear as a login name in the 
/etc/ passwd file, it is taken as a user 
I 


True if the file belongs to the group 
gname. If gname is numeric and does 
not appear in the /etc/group file, it 
is taken as a group ID. 


True if the file is n blocks long (512 
bytes per block). If n is followed by a 
c, the size is in characters. 


True if the file has been accessed in n 
days. The access time of directories in 
path-name-list is changed by find itself. 


RM(1) 


NAME 

rm, rmdir — remove files or directories 
SYNOPSIS 

rm [ -fri | file ... 

rmdir dir ... 
DESCRIPTION 


Rm removes the entries for one or more files from a 
directory. If an entry was the last link to the file, the 
file is destroyed. Removal of a file requires write 
permission in its directory, but neither read nor write 
permission on the file itself. 


If a file has no write permission and the standard input 
is a terminal, its permissions are printed and a line is 
read from the standard input. If that line begins with y 
the file is deleted, otherwise the file remains. No 
questions are asked when the —f option is given or if the 
standard input is not a terminal. 


If a designated file is a directory, an error comment is 
rinted unless the optional argument —r has been used. 
n that case, rm recursively deletes the entire contents of 

the specified directory, and the directory itself. 


If the —-i (interactive) option is in effect, rm asks 
whether to delete each file, and, under —r, whether to 
examine each directory. 


Rmdir removes entries for the named directories, which 
must be empty. 


SEE ALSO 


unlink(2). 


DIAGNOSTICS 


Generally self-explanatory. It is forbidden to remove the 
file .. merely to avoid the antisocial consequences of 
inadvertently doing something like: 


rm —r .* 


NAME 


RMDEL (1) 


rmdel — remove a delta from an SCCS file 


SYNOPSIS 


rmdel —rSID files 


DESCRIPTION 


Rmdel removes the delta specified by the SID from each 
named SCCS file. The delta to be removed must be the 
newest (most recent) delta in its branch in the delta 
chain of each named SCCS file. In addition, the 
specified must not be that of a version being edited for 
the purpose of making a delta (i. e., if a p-file (see 
get(1)) exists for the named SCCS file, the specified 
must not appear in any entry of the p-/file). 


If a directory is named, rmdel behaves as though each 
file in the directory were specified as a named file, 
except that non-SCCS files (last component of the path 
name does not begin with s.) and unreadable files are 
silently ignored. If a name of — is given, the standard 
input is read; each line of the standard input is taken to 
be the name of an SCCS file to be processed; non-SCCS 
files and unreadable files are silently ignored. 


The exact permissions necessary to remove a delta are 
documented in the Source Code Control System User 
Guide. Simply stated, they are either (1) if you make a 
delta you can remove it; or (2) if you own the file and 
directory you can remove a delta. 


FILES 
x.file see delta(1 
Z. a see delta(1 
SEE AL 
delt() get(1), help(1), ce sccsfile(4). 
CTIX Programmer’s Cutde ection 9. 
DIAGNOSTICS 


Use help(1) for explanations. 


ROUTE(1NM) 


NAME 
route — manually manipulate the routing tables 


SYNOPSIS 
etc/route { -f | [ command destination gateway 
metric ] ] 


DESCRIPTION 
Route is a program used to manually manipulate the 
network routing tables. It accepts two commands: add, 
to add a route; and delete, to delete a route. 


All commands have the following syntax: 
/etc/route command destination gateway { metric | 


where destination is a host or network for which the 
route is “‘to’’, gateway is the gateway to which packets 
should be addressed, and metrte is an optional count 
indicating the number of hops to the destination. If no 
metric is specified, route assumes a value of 0. Routes to 
a particular host are distinguished from those to a 
network by interpreting the Internet address associated 
with destination. If the destination has a “local address 
part” of INADDR_ANY, the route is assumed to be to a 
network; otherwise, it is presumed to be a route to a 
host. If the route is to a destination connected via a 
gateway, metrte should be greater than 0. All symbolic 
names specified for a destination or gateway are looked 
up first in the host name database; see hosts(4N). If this 
lookup fails, the name is then looked for in the network 
name database; see networks (4N). 


Route uses a raw socket and the SIOCADDRT and 
SIOCDELRT toctl’s to do its work. As such, only the 
super-user may modify the routing tables. 


If the —f option is specified, route will “flush” the 
routing tables of all gateway entries. If this is used in 
conjunction with one of the commands described above, 
the tables are flushed prior to the command’s 
application. 


DIAGNOSTICS 
“add node: gateway node flags hez-flags’’ 
The specified route is being added to the tables. The 
values printed are from the routing table entry supplied 
in the toctl call. 


“delete node: gateway node flags hez-flags”’ 
As above, but when deleting an entry. 


“node node done” 
When the -f flag is specified, each routing table entry 
deleted is indicated with a message of this form. 
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“not in table” 
A delete operation was attempted for an entry which 
wasn’t present in the tables. 
“routing table overflow” 
An add operation was attempted, but the system was 
low on resources and was unable to allocate memory to 
create the new entry. 

SEE ALSO 
intro(4), netman(1NM), hosts(4N), networks(4N). 
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NAME 
rshd ~— remote shell server 


RSHD(1NM) 


SYNOPSIS 


/etc/rshd 


DESCRIPTION 


Rshd is the network server for programs such as 
remd(LN) and rep(iN) which need to execute a 
noninteractive shell on remote machines. It is normally 
executed by the startup file, /ete/re. 


Rshd enforces an authentication procedure based on 
equivalence of user names (see rhosts(4N)). This 
procedure assumes all nodes on the network are equally 
secure. 


SEE ALSO 
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remd(1N), rep(1N), rhosts(4N). 


NAME 


RSTERM( 1M) 


rsterm — manually start and stop terminal input and 
output 


SYNOPSIS 


/etc/rsterm number device 


DESCRIPTION 


FILES 


Rsterm manually exercises the start/stop features of the 
terminal driver. (For a discussion of start/stop features, 
see the STOP and START characters and [IXON, IXANY, 
and IXOFF flags under termto(7).) Rsterm requires two 
parameters: 


number A number specifying the action: 


O Suspend output, as if the terminal 
had sent a STOP character to the 
system. 


i Resume output, as if the terminal 
had sent a START character to the 
system. 


2 Block input by sending the 
terminal a STOP character, as if 
the terminal had nearly filled the 
terminal’s input queue. 


8 Unblock input by sending the 
terminal a START character, as if 
the system had nearly emptied the 
terminal’s input queue. 


device The special file for the terminal. 


Normally, STOP is the ASCIT XOFF character, 
Control-S, and START is the ASCII XON character, 
Control-Q. 


Operation 2 (resume output) is the most used. Use it 
when a terminal (a printer for example) has sent a STOP 
character and cannot be made to send a START 
character. 


Rsterm is one way to clear up a terminal. Another way 
is to kill all processes associated with the terminal: this 
momentarily closes the special file, returning all terminal 
modes to their initial state. See kill(1). 


You must be superuser to run rsterm. 


/dev/tty??? — terminal devices 


SEE ALSO 


kill(1), termio(7). 


NAME 


RUNACCT (1M) 


runacct — run daily accounting 


SYNOPSIS 


/usr/lib/acct/runacct [mmdd [state] | 


DESCRIPTION 


Runacct is the main daily accounting shell procedure. It 
is normally initiated via cron(1M). Runacct processes 
connect, fee, disk, and process accounting files. It also 
prepares summary files for prdatly or billing purposes. 
Disk block counts are reported for 512-byte blocks. 


Runacct takes care not to damage active accounting files 
or summary files in the event of errors. It records its 
progress by writing descriptive diagnostic messages into 
active. When an error is detected, a message is written 
to /dev/console, mail (see matK1)) is sent to 
root and adm, and runacet terminates. Runacct uses a 
series of lock files to protect against re-invocation. The 
files lock and lockl are used to prevent simultaneous 
invocation, and lastdate is used to prevent more than 
one invocation per day. 


Runacect breaks its processing into separate, restartable 
states using statefile to remember the last state 
completed. It accomplishes this by writing the state 
name into statefile. Runacct then looks in statefile to 
see what it has done and to determine what to process 
next. States are executed in the following order: 


SETUP Move active accounting files into 
working files. 

WTMPFIX Verify integrity of wtmp file, correcting 
date changes if necessary. 

CONNECT1 Produce connect session records in 
etmp.h format. 


CONNECT2 Convert ctmp.h records into tacct.h 


format. 

PROCESS Convert process accounting records into 
tacct.h format. 

MERGE Merge the connect and _ process 
accounting records. 

FEES Convert output of chargefee into 


tacct.h format and merge with connect 
and process accounting records. 


DISK Merge disk accounting records with 
connect, process, and fee accounting 
records. 
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MERGETACCT 
Merge the daily total accounting records 
in daytacct with the summary total 
accounting records in 
/usr/adm/acct/sum/tacct. 


CMS Produce command summaries. 


USEREXIT Any installation-dependent accounting 
programs can be included here. 


CLEANUP Cleanup temporary files and exit. 


To restart runacct after a failure, first check the active 
file for diagnostics, then fix up any corrupted data files 
such as pacct or wtmp. The lock files and lastdate 
file must be removed before runaccé can be restarted. 
The argument mmdd is necessary if runacct is being 
restarted, and specifies the month and day for which 
runacct will rerun the accounting. Entry point for 
processing is based on the contents of statefile; to 
override this, include the desired state on the command 
line to designate where processing should begin. 


EXAMPLES 


FILES 


To start runacct: 
nohup runacct 2> /usr/adm/acct/nite/fd2log & 


To restart runacet: 
nohup runacct 0601 2>> /usr/adm/acct/nite/fd2log & 


To restart runacct at a specific state: 
nohup runacct 0601 MERGE 2>> 
Jost] adm /acct/nite/fddlog & 


/etc/wtmp 

/usr/adm/pacct* 
/usr/sre/emd/acct/tacct.h 
/usr/sre/emd/acct/ctmp.h 
/usr/adm/acct/nite/active 
/usr/adm/acct/nite/daytacct 
/usr/adm/acct/nite/lock 
/usr/adm/acct/nite/lock1 
/usr/adm/acct/nite/lastdate 
/usr/adm/acct/nite/statefile 
/usr/adm/acct/nite/ptacct*.mmdd 


SEE ALSO 


acct(1M), __acctems(1M), _acctcom(1), _ acctcon(1M), 
acctmerg(1M), acctpre(1M), acctsh(1M), cron(1M 
fwtmp(1M), mail(1), acct(2), acct(4), utmp(4) 
MightyFrame Administrator's Reference Manual. 
MiniFrame Administrator’s Manual. 
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BUGS 
Normally it is not a good idea to restart runacct in the 
SETUP state. Run SETUP manually and restart via: 
runacct mmdd WTMPFIX 


If runacct failed in the PROCESS state, remove the last 
ptacct file because it will not be complete. 


RUPTIME( 1N ) 


NAME 

ruptime — display status of nodes on local network 
SYNOPSIS 

/usr/local/bin/ruptime [| -a | { -1] [ -t } [ -u ] 
DESCRIPTION 


Ruptime displays status information for nodes on the 
local network. For each node, a line is_ printed 
displaying: the node name; whether the node is up {a 
node is considered ‘“‘down’”’ if its rwhod(1NM) server has 
not broadcast in five minutes); the time the node has 
been up in days, hours, and minutes; the number of 
logged-in users logged who have used their keyboards in 
the last hour; and the load (average number of jobs in 
the run queue) for the last one minute, five minutes, and 
15 minutes. 


When no options are specified, the status lines are sorted 
by node name. 


Here are the options: 


—a Count all logged-in users, including idle ones. 

-l Sort status lines by load average. 

-t Sort status lines by time node has been up. 

-u Sort status lines by number of users. 
REQUIRMENTS 


FILES 


Each node to be listed must be running the rwhod(1NM) 
server, which broadcasts a status packet once a minute. 
The local node must also be running this server to 
maintain data files. 


/usr/spool/rwho/whod.* data files 


SEE ALSO 
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rwho(1N). 
CTIX Internetworking Manual. 


NAME 


RWHO(1N) 


twho — who is logged in on local network 


SYNOPSIS 


/usr/local/bin/rwho [ —a | 


DESCRIPTION 


Rwho lists users logged in on machines on the local 
network. The format is similar to that of who(1). 
Without options, only users who have typed in the last 
hour are listed. For each user listed, rwho displays the 
user name; the node name; and the date and time the 
user logged in. If the user has not typed in the last 
minute, rwho also displays the user’s idle time in hours 
and minutes. 


Rwho understands the following option: 


—a List all users on active nodes (users idle 
for more than an hour are listed). 


If information from a node is more than five minutes old, 
the node is assumed to be down and its users are not 
listed. 


REQUIREMENTS 


FILES 


Each node to be listed must be running the rwhod(1NM) 
server, which broadcasts a status packet once a minute. 
The local node must also be running this server to 
maintain the data files. 


/usr/spool/rwho/whod.* information about other 
nodes 


SEE ALSO 
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ruptime(1N), rwhod(1NM). 
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NAME 

rwhod ~ node status server 
SYNOPSIS 

/etc/rwhod 
DESCRIPTION 


5/86 


Rwhod collects and distributes information about nodes 
on the local network, including the local node. It is 
normally executed by the startup file, /ete/re. It 
performs four chores once a minute: 


° Gathers information about the local node. 

° Broadcasts information about the local node for 
the benefit of rwhod servers running on other 
nodes. 

° Collects information broadcast by rwhod servers 


on other nodes. 


e Maintains network status files, using information 

gathered by this and the other rwhod servers. 
The files maintained by rwho have names of the form 
/usr/spool/rwho/whod.name, where name is the 
name of the host whose status is in the file. Each status 
file begins with the header of the following form: 


struct whod { 


char wd_vers; /* version number */ 
char wd_type; /* type number */ 
char wd_fill; /* ignored */ 


int wd_sendtime;/* time this packet sent */ 
int wd_recvtime; /* time this packet received */ 
char wd_hostname/32]; 
/* name of originating node */ 
int wd_loadav|3); 
/* load averages 
(see rwho( IN)} * / 
int wd_boottime; 
/* boot time of originating 
node */ 
} 
The node name of a system is printed by the uname(1) 
command. The remainder of the file consists of user 
records: 


FILES 
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struct outmp { 
char out_line(8];_ /* terminal name */ 
char out_name 8]; /* user name */ 
int out_Itime; /* login time */ 
int out_itime; /* idle time */ 
# 
Rwho performs an nlist(3C) on /unix every 10 minutes 
in case that file is not the current system image. 


Rwho transmits and receives messages at the port 
indicated in the “rwho” service specification. See 
services(4N). 


/usr/spool/rwho/whod.* 


WARNINGS 
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Death of this server makes other nodes think that this 
node is down. 


NAME 


SACT(1) 


sact — print current SCCS file editing activity 


SYNOPSIS 


sact files 


DESCRIPTION 


Sact informs the user of any impending deltas to a 
named SCCS file. This situation occurs when get(1) with 
the —e option has been previously executed without a 
subsequent execution of delta(1). If a directory is named 
on the command line, sact behaves as though each file in 
the directory were specified as a named file, except that 
non-SCCS files and unreadable files are silently ignored. 
If a name of — is given, the standard input is read with 
each line being taken as the name of an SCCS file to be 
processed. 


The output for each named file consists of five fields 
separated by spaces. 


Field 1 specifies the SID of a delta that 
currently exists in the SCCS file to 
which changes will be made to make 
the new delta. 


Field 2 specifies the SID for the new delta to 
be created. 
Field 3 contains the logname of the user who 


will make the delta (i.e., executed a 
get for editing). 


Field 4 contains the date that get —e was 
executed. 

Field 5 contains the time that get —e was 
executed. 


SEE ALSO 


delta(1), get(1), unget(1). 


DIAGNOSTICS 


Use help(1) for explanations. 
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NAME 
sadp — disk access profiler 
SYNOPSIS 
sadp [| —th | | —d device/—drive} }] s | n | 
DESCRIPTION 
Sadp reports disk access location and seek distance, in 
tabular or histogram form. It samples disk activity once 
every second during an interval of s seconds. This is 
done repeatedly if n is specified. Cylinder usage and 
disk distance are recorded in units of 8 cylinders. 
The valid value of device is disk. Drive specifies the 
disk drives and it may be: 
a drive number in the range supported by 
device, 
two numbers separated by a minus (indicating 
an inclusive range), 
or 
a list of drive numbers separated by commas. 
Up to 8 disk drives may be reported. The —d option 
may be omitted, if only one device is present. 
The —t flag causes the data to be reported in tabular 
form. The —h flag produces a histogram on the printer 
of the data. Default is —-t. 
EXAMPLE 


FILES 


The command: 
sadp —d disk—0 900 4 


will generate 4 tabular reports, each describing cylinder 
usage and seek distance of disk drive O during a 15- 
minute interval. 


The command: 
sadp —h —d disk-0,16 300 


will generate a histogram for drive 0 (cOdO) and drive 16 
(c1dO) during a 5-minute interval. 


/dev/kmem 


SEE ALSO 


NOTE 


5/86 


MightyFrame Administrator’s Reference Manual. 
MintFrame Administrator’s Manual. 


If the time inverval is too small, sadp will produce an 
invalid report. 
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NAME 
sag — system activity graph 

SYNOPSIS 
sag | options | 

DESCRIPTION 
Sag graphically displays the system activity data stored 
in a binary data file by a previous sar(1) run. Any of 
the sar data items may be plotted singly, or in 
combination; as cross plots, or versus time. Simple 
arithmetic combinations of data may be specified. Sag 
invokes sar and finds the desired data by string- 
matching the data column header (run sar to see what is 
available). These options are passed through to sar: 


-stime Select data later than tzme in the form 
hh [:mm]. Default is 08:00. 


—e time Select data up to time. Default is 18:00. 


—i sec Select data at intervals as close as possible to 
sec seconds. 


-f file Use file as the data source for sar. Default is 
the current daily data file 
/usr/adm/sa/sadd. 


Other options: 

—T term Produce output suitable for terminal term. 
See tplot(1G) for known terminals. If term is 
vpr, output is processed by vpr —p and 
queued to a Versatec printer. Default for term 


is $TERM. 
—x spec xX axis specification with spec in the form: 
"name lop name]... [lo hil” 


—y spec y axis specification with spec in the same form 
as above. 


Name is either a string that will match a column header 
in the sar report, with an optional device name in square 
brackets, e.g., r-+w/s[dsk—1], or an integer value. Op 
is + — * or / surrounded by blanks. Up to five names 
may be specified. Parentheses are not recognized. 
Contrary to custom, + and —_ have precedence over 

* and /. Evaluation is left to right. Thus 
A / A+B * 100 is evaluated (A/(A+B))*100, and 
A+B/C+4D is (A+B)/(C+D). Lo and hi are 
optional numeric scale limits. If unspecified, they are 
deduced from the data. 


A single spec is permitted for the x axis. If unspecified, 
time is used. Up to 5 spec’s separated by ; may be 


Ase 
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given for —y. Enclose the —x and —y arguments in ” ” 
if blanks or \<CR> are included. The —y default is: 


-y "%usr 0 100; %usr + %sys 0 100; 
ousr + %sys + %wio O 100” 


EXAMPLES 
To see today’s CPU utilization: 
sag 


To see activity over 15 minutes of all disk drives: 
TS=*date +%H:%M* 
sar —o tempfile 60 15 
TE=*‘date +%H:%M* 
sag -f tempfile -s $TS -e $TE -y "r+w/s{dsk]” 


FILES 
/usr/adm/sa/sadd daily data file for day dd. 


SEE ALSO 
sar(1), tplot(1G). 
MightyFrame Administrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 
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NAME 
sar — system activity reporter 


SYNOPSIS 
sar | —ubdycwaqvmprAC | [ -o file] t | n | 


- ene [-s time] [-e time | 


DESCRIPTION 

Sar, in the first instance, samples cumulative activity 
counters in the operating system at n intervals of ¢ 
seconds. If the —o option is specified, it saves the 
samples in file in binary format. The default value of n 
is 1. In the second instance, with no sampling interval 
specified, sar extracts data from a previously recorded 
file, either the one specified by —f option or, by default, 
the standard system activity daily data file 
/usr/adm/sa/sadd for the current day dd. The 
starting and ending times of the report can be bounded 
via the -—s and —-e ttme arguments of the form 
hh[:mm/[:ss]]. The —i option selects records at sec 
second intervals. Otherwise, all intervals found in the 
data file are reported. 


In either case, subsets of data to be printed are specified 


by option: 
—u_ Report CPU utilization (the default): 
%usr, %sys, Ywio, %idle - portion of time 


running in user mode, running in system mode, idle 
with some process waiting for block I/O, and 
otherwise idle. 

-b Report buffer activity: 


bread/s, bwrit/s — transfers per second of data 
between system buffers and disk or other block 
devices; 


lread/s, lwrit/s — accesses of system buffers; 
%rcache, Y%weache — cache hit ratios, e. g., 1 - 
bread/lread; 

pread/s, pwrit/s - transfers via raw (physical) 
device mechanism. 

-d_ Report activity for each block device, e. g., disk or 
tape drive. When data is displayed, the device 
specification dsk- is generally used to represent a 
disk drive. The device specification used to 
represent a tape drive is machine dependent. The 
activity data reported is: 

%busy, avque — portion of time device was busy 
servicing a transfer request, average number of 
requests outstanding during that time; 

r+w/s, blks/s — number of data transfers from or 
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to device, number of bytes transferred in 512-byte 
units; 

avwait, avserv — average time in ms. that transfer 
requests wait idly on queue, and average time to be 
serviced (which for disks includes seek, rotational 
latency and data transfer times). RS-422 activity 
is also reported in this section. 

Report TTY device activity: 

rawch/s, canch/s, outch/s — input character rate, 
input character rate processed by canon, output 
character rate; 

revin/s, xmtin/s, mdmin/s — receive, transmit and 
modem interrupt rates. 

Report system calls: 

scall/s — system calls of all types; 

sread/s, swrit/s, fork/s, exec/s — specific system 
calls; 

rchar/s, wchar/s — characters transferred by read 
and write system calls. 

Report system swapping and switching activity: 
swpin/s, swpot/s, bswin/s, bswot/s — number of 
transfers and number of 512-byte units transferred 
for swapins and swapouts (including initial loading 
of some programs); 

pswch/s — process switches. 

Report use of file access system routines: 

iget/s, namei/s, dirblk/s. 

Report average queue length while occupied, and 
% of time occupied: 


runq-sz, Y%orunoce — run queue of processes in 
memory and runnable; 
swpq-sz, Yswpoce -— swap queue of processes 


swapped out but ready to run. 

Report status of process, i-node, file, record lock 
and file header tables: 

proc-sz, inod-sz, file-sz, lock-sz, fhdr-sz — 
entries/size for each table, evaluated once at 
sampling point; 

ov ~ overflows that occur between sampling points 
for each table. 

Report message and semaphore activities: 

msg/s, sema/s — primitives per second. 

Report paging activity: 

vflt/s, pflt/s, pgfil/s, relm/s —number of address 
translation faults, protection faults, page ins from 
file system and pages reclaimed occurring per 
second. 

Report free swap and memory space: 

freemem — number of free pages of memory; 
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freeswp — number of free blocks of swap space; the 
free space reported is not contiguous. 

-A_ Report all data. Equivalent to 
—udqbwcayvympC. 

-C 


In addition to rates, print the actual counts. This 
is useful if the rates are 0. 
EXAMPLES 
To see today’s CPU activity so far: 
sar 
To watch CPU activity evolve for 10 minutes and save 
data: 
sar ~o temp 60 10 
To later review disk and tape activity from that period: 
sar ~d —f temp 
FILES 
/usr/adm/sa/sadd daily data file, where dd are digits 
representing the day of the month. 
SEE ALSO 
sag(1G), sar(1M). 
MightyFrame Admintstrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 
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NAME 
sal, sa2, sade — system activity report package 


SYNOPSIS 
/usr/lib/sa/sade {t nj { ofile | 


/usr/lib/sa/sal {t n) 


usr/lib/sa/sa2 [—-ubdyewaqvmprAC] [-s time | 
—e time] [-—i sec 


DESCRIPTION 

System activity data can be accessed at the special 
request of a user (see sar(1)) and automatically on a 
routine basis as described here. The operating system 
contains a number of counters that are incremented as 
various system actions occur. These include CPU 
utilization counters, buffer usage counters, disk and tape 
I/O activity counters, TTY device activity counters, 
switching and system-call counters, file-access counters, 
queue activity counters, and counters for interprocess 
communications. 


Sadc and shell procedures, sal and sa2 are used to 
sample, save, and process this data. 


Sadc, the data collector, samples system data n times 
every ¢ seconds and writes in binary format to ofile or to 
standard output. If ¢ and n are omitted, a special record 
is written. This facility is used at system boot time to 
mark the time at which the counters restart from zero. 
The /etc/re entry: 
su sys ~—c "/usr/lib/sa/sade /usr/adm/sa/sa‘date +%d‘” 

writes the special record to the daily data file to mark 
the system restart. 


The shell script sal, a variant of sadc, is used to collect 
and store data in binary file /usr/adm/sa/sadd where 
dd is the current day. The arguments ¢ and n cause 
records to be written n times at an interval of t seconds, 
or once if omitted. The entries in 
/usr/spool/cron/crontabs/sys (see cron(1M)): 


0 * * * 0,6 /usr/lib/sa/sal 
O 8-17 * * 1-5 /usr/lib/sa/sal 1200 3 
0 18-7 * * 1-5 /usr/lib/sa/sal 


will produce records every 20 minutes during working 
hours and hourly otherwise. 


The shell script sa2, a variant of ser writes a daily 
report in file /usr/adm/sa/sardd. The options are 
explained in sar(1). The entry in 
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/usr/spool/cron/crontabs/sys: 
5 18 * * 1-5 /usr/lib/sa/sa2 —s 8:00 —e 18:01 -i 
3600 -A 


will report important activities hourly during the 
working day. 
The structure of the binary daily data file is: 


struct sa { 
struct sysinfo si; 
/* see toe ar ne lese tae erate: wh */ 
struct minfo 
/* defined in /usr/include/sys/sysinfo. h */ 
int szinode; 
* current size of inode table */ 
int szfile; 
/* current size of file table */ 
int szproc; 
/* current size of proc table */ 
int szickf; 
* current size of file record header table */ 
int szlckr; 
/* current size of file record lock table */ 
int mszinode; 
/* size of inode table */ — 
int mszfile; 
[* size of file table */ 
int mszproc; 
/* size of proc table */ 
int mszickf; 
/* maximum ‘size of file record header table */ 
int mszlckr; 
/* maximum size of file record lock table */ 
long inodeovf; 
{ * cumulative overflows of inode table */ 
ong fileovf; 
( * cumulative overflows of file table */ 
ong procovf; 
/* cumulative overflows of proc table */ 
time_t ts; 
/* time stamp * / 
int apstate; 
long devio[NDEVS](4]; 
/* device unit information */ 
#define 1O_OPSO 
/* cumulative I/O requests */ 
#define [O_BCNT1 
/* cumulative blocks transferred */ 
#define IO_ACT2 


SAR(1M) 


/* cumulative drive busy time in ticks */ 
#define IO_RESP3 
/* cumul. 1/O resp time in ticks since boot */ 


/usr/adm/sa/sadd daily data file 
j isriadm/se) sat dd daily report file 
/tmp/sa.adrfl address file 
SEE ALSO 
cron(1M), sag(1G), sar(1), timex(1). - 
MightyFrame Administrator’s Reference Manual. 
MintFrame Administrator’s Manual. 


FILES 


SCCSDIFF (1) 


NAME 

sccsdiff — compare two versions of an SCCS file 
SYNOPSIS 

scesdiff —rSID1 —rSID2 [—p] [—sn] files 
DESCRIPTION 


Scesdiff compares two versions of an SCCS file and 
generates the differences between the two versions. Any 
number of SCCS files may be specified, but arguments 
apply to all files. 
—rsID? SID1 and SID2 specify the deltas of 
an SCCS file that are to be compared. 
Versions are passed to bdiff(1) in the 
order given. 


—p pipe output for each file through 
pr(1). 
—sn n is the file segment size that bdiff 


will pass to diff(1). This is useful 
when diff fails due to a high system 
load. 


FILES 


SEE ALSO 
bdiff(1), get(1), help(1), pr(1). 
CTIX Programmer’s Guide, Section 9. 


DIAGNOSTICS 
“file: No differences” If the two versions are the 
same. 
Use help(1) for explanations. 
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NAME 
script — make typescript of terminal session 


SYNOPSIS 
script { —a | | —q | [ —S shell ] [ file | 


DESCRIPTION 

Script makes a typescript of your interaction with the 
system. Scrtpt forks a shell with standard input and 
output diverted to pipes. Input to sertpt is written to 
the shell’s input pipe; script writes the shell’s output 
pipe; and a typescript of both is written to file. The 
default for file is typescript. File begins and ends with 
time stamps for the session. Script terminates with an 
error if file already exists. 


To terminate script, terminate the shell or type 
Control-D_ (FINISH on Convergent Technologies 
Terminals). A Control-D to sertpt terminates the shell 
and all programs run from the shell by closing the pipes. 
Control-D behaves as though you had typed an infinite 
number of Control-Ds. 


The run file for the shell is taken from the SHELL 
environment variable, set by login(1M). If SHELL is 
not set, /bin/sh is used. 


Here are the options: 


-q Quiet operation. Seript’s opening and closing 
messages are suppressed, as are the time stamps 
at the beginning and end of file. 


—S shell 
Use shell as the name of the shell run file. 


-—a If file already exists, append typescript to it. 


WARNINGS 
Script’s limitations result from its use of pipes: 


There is no way to send an end-of-file to the 
shell without terminating scrtpt. 


Programs that use the standard input to 
examine and control the user’s terminal will 
have problems or not work at all. Examples are 
atty(1), tset(1), tty(1), ez(1), and vt(1). 

When the user interrupts a printing process, 
sertpt attempts to flush the output backed up in 
the pipe for better response. Usually the next 
prompt also gets flushed. 
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NAME 

sdb — symbolic debugger 
SYNOPSIS 

sdb [—w] [—W] [ objfil | corfil [ directory-list | ] | 
DESCRIPTION 


Sdb is a symbolic debugger that can be used with C 
programs. It may be used to examine their object files 
and core files and to provide a controlled environment 
for their execution. 


Obdjfil is normally an executable program file which has 
been compiled with the —g (debug) option; if it has not 
been compiled with the —g option, or if it is not an 
executable file, the symbolic capabilities of sdb will be 
limited, but the file can still be examined and the 
program debugged. The default for objfil is a.out. 
Corfil is assumed to be a core image file produced after 
executing objfil; the default for corfil is core. The core 
file need not be present. A — in place of corfil will force 
sdb to ignore any core image file. The colon separated 
list of directories (dtrectory-ltst) is used to locate the 
source files used to build objfil. 


It is useful to know that at any time there is a current 
line and current file. If corfil exists then they are —_ 
initially set to the line and file containing the source 

statement at which the process terminated. Otherwise, 

they are set to the first line in main(). The current line 

and file may be changed with the source file examination 
commands. 


Initially sdb has a greater-than character (>) prompt, 
which indicates that sdb is ready for the user to enter the 
first command. After sdb has begun, the prompt is 
<2z>, where z is the name of the last command given. 


By default, warnings are provided if the source files used 
in producing objfil cannot be found, or are newer than 
objfil. This checking feature and the accompanying 
warnings may be disabled by the use of the —W flag. 


Names of variables are written just as they are in C. 
Note that names in C are now of arbitrary length, sdb 
will no longer truncate names. Variables local to a 
procedure may be accessed using the form 
procedure:varitable. If no procedure name is given, the 
procedure containing the current line is used by default. 


It is also possible to refer to structure members as 
vartable.member, pointers to structure members as 
variable — > member and array elements as 
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vartable[number|]. Pointers may be dereferenced by 
using the form pointer(0]. Combinations of these forms 
may also be used. A number may be used in place of a 
structure variable name, in which case the number is 
viewed as the address of the structure, and the template 
used for the structure is that of the last structure 
referenced by sdb. An unqualified structure variable may 
also be used with various commands. Generally, sdb will 
interpret a structure as a set of variables. Thus, sdb will 
display the values of all the elements of a structure when 
it is requested to display a structure. An exception to 
this interpretation occurs when displaying variable 
addresses. An entire structure does have an address, and 
it is this value sdb displays, not the addresses of 
individual elements. 


Elements of a multidimensional array may be referenced 

variable [number][number]..., or as 
variable [number,number,...]. In place of number, the 
form numbers;number may be used to indicate a range of 
values, * may be used to indicate all legitimate values 
for that subscript, or subscripts may be omitted entirely 
if they are the last subscripts and the full range of values 
is desired. As with structures, sdb displays all the values 
of an array or of the section of an array if trailing 
subscripts are omitted. It displays only the address of 
the array itself or of the section specified by the user if 
subscripts are omitted. 


A particular instance of a variable on the stack may be 
referenced by using the form procedure:vartable number. 
All the variations mentioned in naming variables may be 
used. Number is the occurrence of the specified 
procedure on the stack, counting the top, or most 
current, as the first. If no procedure is specified, the 
procedure currently executing is used by default. 


It is also possible to specify a variable by its address. All 
forms of integer constants which are valid in C may be 
used, so that addresses may be input in decimal, octal or 
hexadecimal. 


Line numbers in the source program are referred to as 
file-name:number or procedure:number. In either case 
the number is relative to the beginning of the file. If no 
procedure or file name is given, the current file is used 
by default. If no number is given, the first line of the 
named procedure or file is used. 


While a process is running under sdb, all addresses refer 
to the executing program; otherwise they refer to objfil 
or corfil. An initial argument of ~w permits overwriting 
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locations in objfil. 


Addresses 
The address in a file associated with a written address is 
determined by a mapping associated with that file. Each 
mapping is represented by two triples (b1, e1, fi) and 
(62, ¢2, f2) and the file address corresponding to a 
written address is calculated as follows: 


b1address< el 


file address address +f1-b1 
otherwise 


b2address< e2 


file address address +f2- b2, 


otherwise, the requested address is not legal. In some 
cases (e.g., for programs with separated I and D space) 
the two segments for a file may overlap. 


The initial setting of both mappings is suitable for 
normal a.out and core files. If either file is not of the 
kind expected then, for that file, b1 is set to 0, e1 is set 
to the maximum file size, and fi is set to 0; in this way 
the whole file can be examined with no address 
translation. 


In order for sdb to be used on large files, all appropriate 
values are kept as signed 32-bit integers. 


Commands 
The commands for examining data in the program are: 
t Print a stack trace of the terminated or halted 
program. 
T Print the top line of the stack trace. 
variable /clm 


Print the value of vartable according to length / 
and format m. A numeric count c indicates that a 
region of memory, beginning at the address implied 
by variable, is to be displayed. The length 
specifiers are: 


one byte 
h two bytes (half wore) 
I four bytes (long word) 
Legal values for m are: 
c character 
d decimal 
u decimal, unsigned 
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o octal 

x hexadecimal 

f 32-bit single precision floating 
point 

g 64-bit double precision floating 
point 

8 Assume vartable is a string pointer 


and print characters starting at the 
address pointed to by the variable. 
a Print characters starting at the 
variable’s address. This format 
may not be used with register 


variables. 
p pointer to procedure 
i disassemble machine-language 


instruction with addresses printed 
numerically and symbolically. 

I disassemble machine-language 
instruction with addresses just 
printed numerically. 

The length specifiers are only effective with the 
formats c, d, u, o and x. Any of the specifiers, c, 
|, and m, may be omitted. If all are omitted, sdb 
choses a length and a format suitable for the 
variable’s type as declared in the program. If m is 
specified, then this format is used for displaying 
the variable. A length specifier determines the 
output length of the value to be displayed, 
sometimes resulting in truncation. A count 
specifier c tells sdb to display that many units of 
memory, beginning at the address of vartable. The 
number of bytes in one such unit of memory is 
determined by the length specifier /, or if no length 
is given, by the size associated with the vartable. If 
a count specifier is used for the s or a command, 
then that many characters are printed. Otherwise 
successive characters are printed until either a null 
byte is reached or 128 characters are printed. The 
last variable may be redisplayed with the command 


The sh(1) metacharacters * and ? may be used 
within procedure and variable names, providing a 
limited form of pattern matching. If no procedure 
name is given, variables local to the current 
procedure and global variables are matched; if a 
procedure name is specified then only variables 
local to that procedure are matched. To match 
only global variables, the form :pattern is used. 


ode 
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linenumber?lm 

vartable:?lm 
Print the value at the address from a.out or I 
space given by linenumber or vartable (procedure 
name), according to the format Im. The default 
format is ‘i’. 


variable =Im 

linenumber=Im 

number=Im 
Print the address of variable or linenumber, or the 
value of number, in the format specified by Im. If 
no format is given, then lx is used. The last 
variant of this command provides a convenient way 
to convert between decimal, octal and hexadecimal. 


vartable!value 

Set variable to the given value. The value may be 
a number, a character constant or a variable. The 
value must be well defined; expressions which 
produce more than one value, such as structures, 
are not allowed. Character constants are denoted 
‘character. Numbers are viewed as integers unless 
a decimal point or exponent is used. In this case, 
they are treated as having the type double. 
Registers are viewed as integers. The variable may 
be an expression which indicates more than one 
variable, such as an array or structure name. If 
the address of a variable is given, it is regarded as 
the address of a variable of type int. C 
conventions are used in any type conversions 
necessary to perform the indicated assignment. 


f Print the 68881 floating-point registers. 


x Print the machine registers and the current 
machine-language instruction. 


X = Print the current machine-language instruction. 
The commands for examining source files are: 


e procedure 

e file-name 

e directory/ 

e directory file-name 
The first two forms set the current file to the file 
containing procedure or to file-name. The current 
line is set to the first line in the named procedure 
or file. Source files are assumed to be in directory. 
The default is the current working directory. The 
latter two forms change the value of directory. If 
no procedure, file name, or directory is given, the 
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current procedure name and file name are reported. 


/regular expression / 
Search forward from the current line for a line 
containing a string matching regular expression as 
in ed(1). The trailing / may be omitted. 


?regular expression? 
Search backward from the current line for a line 
containing a string matching regular expression as 
in ed(1). The trailing ? may be deleted. 


Print the current line. 


z Print the current line followed by the next 9 lines. 
Set the current line to the last line printed. 


w Window. Print the 10 lines around the current 
line. 


number 
Set the current line to the given line number. 
Print the new current line. 


count+ 
Advance the current line by count lines. Print the 
new current line. 


count— 
Retreat the current line by count lines. Print the 
new current line. 


The commands for controlling the execution of the 
source program are: 


count Yr args 

count R 
Run the program with the given arguments. The r 
command with no arguments reuses the previous 
arguments to the program while the R command 
runs the program with no arguments. An 
argument beginning with < or > _ causes 
redirection for the standard input or output, 
respectively. If count is given, it specifies the 
number of breakpoints to be ignored. 


linenumber c count 

linenumber C count 
Continue after a breakpoint or interrupt. If count 
is given, it specifies the breakpoint at which to 
stop after ignoring count - 1 breakpoints. C 
continues with the signal which caused the 
program to stop reactivated and c¢ ignores it. If a 
line number is specified, a temporary breakpoint is 
placed at the line and execution is continued. This 
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temporary breakpoint is deleted when the 
command finishes. 


linenumber g count 
Continue after a breakpoint with execution 
resumed at the given line. If count is given, it 
specifies the number of breakpoints to be ignored. 


s count 

S count 
Single step the program through count lines. If no 
count is given then the program is run for one line. 
S is equivalent to s except it steps through 
procedure calls. 


me 


I Single step by one machine-language instruction. I 
steps with the signal which caused the program to 
stop reactivated and i ignores it. 


variable$m count 

address:m count 
Single step (as with s) until the specified location i : 
modified with a new value. If count is omitted, 
is effectively infinity. Variable must be oe 
from the current procedure. Since this command is 
done by software, it can be very slow. 


level v 

Toggle verbose mode, for use when single stepping 
with S, s or m. If level is omitted, then just the 
current source file and/or subroutine name is 
printed when either changes. If level is 1 or 
greater, each C source line is printed before it is 
executed; if level is 2 or greater, each assembler 
statement is also printed. A v turns verbose mode 
off if it is on for any level. 


k Kill the program being debugged. 


procedure(argl,arg2.,... 

procedure(argl ,arg2,...)/m 
Execute the named procedure with the given 
arguments. Arguments can be integer, character or 
string constants or names of variables accessible 
from the current procedure. The second form 
causes the value returned by the procedure to be 
printed according to format m. If no format is 
given, it defaults to d. 


linenumber b commands 
Set a breakpoint at the given line. If a procedure 
name without a line number is given (e.g., 
“proc:”), a breakpoint is placed at the first line in 


sot 


SDB(1) 


the procedure even if it was not compiled with the 
—g option. If no isnenumber is given, a breakpoint 
is placed at the current line. If no commands are 
given, execution stops just before the breakpoint 
and control is returned to sdb. Otherwise the 
commands are executed when the breakpoint is 
encountered and execution continues. Multiple 
commands are specified by separating them with 
semicolons. If k is used as a command to execute 
at a breakpoint, control returns to sdb, instead of 
continuing execution. 


B_ Print a list of the currently active breakpoints. 


linenumber d 
Delete a breakpoint at the given line. If no 
linenumber is given then the breakpoints are 
deleted interactively. Each breakpoint location is 
printed and a line is read from the standard input. 
If the line begins with a y or d then the breakpoint 


is deleted. 
D__séODelete all breakpoints. 
] Print the last executed line. 


linenumber a 
Announce. If linenumber is of the form 
procsnumber, the command effectively does a 
linenumber b 1. If linenumber is of the form proc:, 
the command effectively does a proc: b T. 


Miscellaneous commands: 


!command 
The command is interpreted by sh(1). 


new-line 
Perform the previous command again. 


control-D 
Scroll. Print the next 10 lines of instructions, 
source or data depending on which was printed 
last. 


< filename 

Read commands from filename until the end of file 
is reached, and then continue to accept commands 
from standard input. When sdb is told to display a 
variable by a command in such a file, the variable 
name is displayed along with the value. This 
command may not be nested; < may not appear 
as a command in a file. 
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M_ Print the address maps. 
M PA] bef 
ecord new values for the address map. The 

arguments ? and / specify the text and data maps, 
respectively. The first segment, (61, ¢1, f1), is 
changed unless * is specified, in which case the 
second segment (b1, e1, fl), of the mapping is 
changed. If fewer than three values are given, the 
remaining map parameters are left unchanged. 

” string 
Print the given string. The C escape sequences of 
the form \character are recognized, where 
character is a nonnumeric character. 


q Exit the debugger. 


The following commands also exist and are intended only 
for debugging the debugger: 


V_s*Print the version number. 
Q_s~Print a list of procedures and files being debugged. 
Y Toggle debug output. 


Sdb may be instructed to monitor a given memory 
location and stop the program when the value at that 
location changes in any given way. For example: 


> if x <= 123 The above example instructs sdb 
to monitor the value at location x. When the 
user gives the command to continue (c), sdb 
checks the value of x at every source line 
executed and stops the program if the given 
condition becomes true. Note that use of this 
construct slows the real-time execution of a 
program. 


The syntax of the if command is as follows: 


if Shows a list of the current data breakpoints; 
assigns a number to each. 


if var Monitors the value of var and stops the program 
if the value changes. A variable name may be 
used for var, as well as a constant address. 
Comparisons are done as either 4-byte signed or 
4-byte unsigned, depending on the data type. 
To perform a 1I-byte or 2-byte comparison, an 
optional length value may accompany var. An 
example of a 2-byte comparison is 


if x,2 = Oxff 


if var rel value 
Compares the value of var to the constant given 
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and stops the program if the condition is true. 
The values of rel may be =, ==, <, <=, 
>, >=, or!l=. 

off n Disables or turns off a data breakpoint without 
removing it from the list. 


onn_ Enables a breakpoint that was turned off. 
out n Removes a breakpoint from the list. 


Conditional breakpoints are used in a manner similar to 
data breakpoints, except that the user specifies a place in 
the program at which sdb should stop to check the data 
values. For example, 


mysub:99 b if xyz = 123 


The above example instructs sdb to check the value of 
xyz every time the program arrives at line 99 of 
subroutine mysub. If the condition is true, then 
execution stops there, as with a normal breakpoint. This 
type of breakpoint does not monitor the value xyz at 
every line of code, as the data breakpoint does. 


FILES 
a.out 
core 
SEE ALSO 


ec(1), sh(1). 


a.out(4), core(4). 


WARNINGS 


BUGS 


5/86 


When sdb prints the value of an external variable for 
which there is no debugging information, a warning is 
printed before the value. The value is assumed to be int 
(integer). 

Data which are stored in text sections are 
indistinguishable from functions. 


Line number information in optimized functions is 
unreliable, and some information may be missing. 


If a procedure is called when the program is not stopped 
at a breakpoint (such as when a core image is being 
debugged), all variables are initialized before the 
procedure is started. This makes it impossible to use a 
procedure which formats data from a core image. 


When setting a breakpoint at a procedure, sdb will 
inconsistently produce the incorrect line number. 
Recompiling the source program will correct this 
problem. 
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sdiff - side-by-side difference program 


SYNOPSIS 


sdiff [ options ... | filel file2 


DESCRIPTION 


Sdiff uses the output of diff(1) to produce a side-by-side 
listing of two files indicating those lines that are 
different. Each line of the two files is printed with a 
blank gutter between them if the lines are identical, a < 
in the gutter if the line only exists in féle1, a > in the 
gutter if the line only exists in file2, and a | for lines 
that are different. 


For example: 


x | y 

a a 

b < 

c < 

d d 
> c 


The following options exist: 


—win 

-| 

~s 

~o output 


Use the next argument, n, as the width of 
the output line. The default line length is 
130 characters. 


Only print the left side of any lines that are 
identical. 


Do not print identical lines. 


Use the next argument, output, as the name 
of a third file that is created as a user- 
controlled merging of file1 and file2. 
Identical lines of filet and file2 are copied 
to output. Sets of differences, as produced 
by diff(1), are printed; where a set of 
differences share a common gutter character. 
After printing each set of differences, sdiff 
prompts the user with a % and waits for 
one of the following user-typed commands: 


1 append the left column to 
the output file 


r append the right column to 
the output file 


8 turn on silent mode; do not 
print identical lines 


SDIFF (1) 


turn off silent mode 

el call the editor with the left 
column 

er call the editor with the 
right column 


eb call the editor with the 
concatenation of left and 


right 

e call the editor with a zero 
length file 

q exit from the program 


On exit from the editor, the resulting file is 
concatenated on the end of the output file. 


SEE ALSO 
diff(1), ed(1). 
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NAME 

sed — stream editor 
SYNOPSIS 

sed [ —n | [ —e script | [ -f sfile | [ files ] 
DESCRIPTION 


Sed copies the named files (standard input default) to 
the standard output, edited according to a script of 
commands. The —f option causes the script to be taken 
from file sfile; these options accumulate. If there is just 
one ~—e option and no —f options, the flag —e may be 
omitted. The —n option suppresses the default output. 
A script consists of editing commands, one per line, of 
the following form: 


[ address | , address ] | function [ arguments | 


In normal operation, sed cyclically copies a line of input 
into a pattern space (unless there is something left after 
a D command), applies in sequence all commands whose 
addresses select that pattern space, and at the end of 
the script copies the pattern space to the standard 
output (except under —n) and deletes the pattern space. 


Some of the commands use a hold space to save all or 
part of the pattern space for subsequent retrieval. 


An address is either a decimal number that counts input 
lines cumulatively across files, a $ that addresses the last 
line of input, or a context address, i.e, a /regular 
expresston/ in the style of ed(1) modified thus: 


In a context address, the construction \fregular 
ezpresston?, where ? is any character, 
is identical to /regular ezpression/. 
Note that in the context address 
\xabc\xdefx, the second x stands for 
itself, so that the regular expression is 
abexdef. 

The escape sequence \n matches a new-line 
embedded in the pattern space. 

A period . matches any character except the 
terminal new-line of the pattern space. 

A command line with no addresses selects every 
pattern space. 

A command line with one address selects each 
pattern space that matches the address. 

A command line with two addresses selects the 
inclusive range from the first pattern 
space that matches the first address 
through the next pattern space that 
matches the second. (If the second 
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address is a number less than or equal to 
the line number first selected, only one 
line is selected.) Thereafter the process 
is repeated, looking again for the first 
address. 


Editing commands can be applied only to non-selected 
pattern spaces by use of the negation function ! (below). 


In the following list of functions the maximum number 
of permissible addresses for each function is indicated in 
parentheses. 


The text argument consists of one or more lines, all but 
the last of which end with \ to hide the new-line. 
Backslashes in text are treated like backslashes in the 
replacement string of an s command, and may be used 
to protect initial blanks and tabs against the stripping 
that is done on every script line. The rfile or wfile 
argument must terminate the command line and must be 
preceded by exactly one blank. Each wftle is created 
before processing begins. There can be at most 10 
distinct wftle arguments. 

(1) a\ 

teat Append. Place tezt on the output before 
reading the next input line. 

(2) b label Branch to the : command bearing the /abel. 
If label is empty, branch to the end of the 
script. 

(2) e\ 

text Change. Delete the pattern space. With 0 or 
1 address or at the end of a 2-address range, 
place text on the output. Start the next 


cycle. 

(2) d Delete the pattern space. Start the next 
cycle. 

(2) D Delete the initial segment of the pattern 
space through the first new-line. Start the 
next cycle. 

(2)g Replace the contents of the pattern space by 
the contents of the hold space. 

(2)G Append the contents of the hold space to the 
pattern space. 

(2)h Replace the contents of the hold space by the 
contents of the pattern space. 

(2) H Append the contents of the pattern space to 


the hold space. 


tezt Insert. Place tezt on the standard output. 


(1)q 
(2) r rfile 
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List the pattern space on the standard output 
in an unambiguous form. Non-printing 
characters are spelled in two-digit ASCII and 
long lines are folded. 

Copy the pattern space to the standard 
output. Replace the pattern space with the 
next line of input. 

Append the next line of input to the pattern 
space with an embedded new-line. (The 
current line number changes.) 

Print. Copy the pattern space to the 
standard output. 

Copy the initial segment of the pattern space 
through the first new-line to the standard 
output. 

Quit. Branch to the end of the script. Do 
not start a new cycle. 

Read the contents of rftle. Place them on 
the output before reading the next input line. 


(2) s/regular expression /replacement / flags 


(2) t label 


(2) w wfile 
(2) x 


Substitute the replacement string for 
instances of the regular ezpresston in the 
pattern space. Any character may be used 
instead of /. For a fuller description see 
ed(1). Flags is zero or more of: 

n n= 1 - 512. Substitute for 
just the nth occurrence of 
the regular expression. 

g Global. Substitute for all 
nonoverlapping instances of 
the regular expression rather 
than just the first one. 

p Print the pattern space if a 
replacement was made. 

w wfile Write. Append the pattern 
space to ufile if a 
replacement was made. 

Test. Branch to the : command bearing the 
label if any substitutions have been made 
since the most recent reading of an input line 
or execution of at. If label is empty, branch 
to the end of the script. 


Write. Append the pattern space to wile. 
Exchange the contents of the pattern and 
hold spaces. 


(2) y/string1 /string2 / 


Transform. Replace all occurrences of 
characters in string! with the corresponding 
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character in string2. The lengths of stringJ 
and string2 must be equal. 


(2)! function 


SEE ALSO 


Don’t. Apply the function (or group, if 
function is {) only to lines not selected by 
the address(es). 

This command does nothing; it bears a label 
for b and t commands to branch to. 

Place the current line number on_ the 
standard output as a line. 

Execute the following commands through a 
matching } only when the pattern space is 
selected. 

If a # appears as the first character on the 
first line of a script file, that entire line is 
treated as a comment, with one exception. If 
the character after the # is an ’n’, then the 
default output will be suppressed. The rest 
of the line after #n is also ignored. A script 
file must contain at least one non-comment 
line. 


awk(1), ed(1), grep(1). 
CTIX Programmer’s Guide, Section 15. 
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setaddr — set DARPA Internet address from node name 


SYNOPSIS 


/ete/setaddr 


DESCRIPTION 


FILES 


Setaddr sets the DARPA Internet address of the system. 
It gets the address by using the node name to find the 
local system’s entry in /ete/hosts (see hosts (4)). The 
node name must have been previously set by the 
setuname(1M) command or setuname(2) system call. 
Setaddr is executed at boot time. It should appear in 
/ete/re (see bre(1M)) after setuname and before the 
networking servers. 


/etc/hosts names and addresses of hosts 


SETENET(1NM) (MiniFrame Only ) 


NAME 

setenet — write Ethernet address on disk 
SYNOPSIS 

/etc/setenet address 
DESCRIPTION 


Setenet writes an Ethernet Address, specified by its 
parameter, into the volume home block of disk 0. It is 
run once only before any other Ethernet software. The 
Ethernet Address is a 32-bit integer that uniquely 
identifies each computer system running Ethernet. 
Setenet requires it to be in hexadecimal. 


Setenet employs iv(1) to actually modify the volume 
home block; this produces some irrelevant information 
about the bad block table. 


FILES 
/dev /fp000 reserved area of disk 0 


SEE ALSO 
iv(1), fp(7). 
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NAME 

setmnt — establish mount table 
SYNOPSIS 

/etc/setmnt 
DESCRIPTION 


FILES 


Setmnt creates the /etc/mnttab table (see mnittab(4)), 
which is needed for both the mount(1M) and umount 
commands. Setmnt reads standard input and creates a 
mnttab entry for each line. Input lines have the format: 


filesys node 


where filesys is the name of the file system’s spectal file 
(e.g., dsk etary) and node is the root name of that file 
system. Thus filesys and node become the first two 
strings in the mnttab(4) entry. 


/etc/mnttab 


SEE ALSO 


BUGS 


devnm(1M), mount(1M), mnttab(4). 


Evil things will happen if filesys or node are longer than 
32 characters. 

Setmnt silently enforces an upper limit on the maximum 
number of mnttab entries. 


SETUNAME (1M) 


NAME 
setuname — set name of system 
SYNOPSIS 
etc/setuname [ -s sysname ] | —n nodename | 
—r release | [| —v version | 
DESCRIPTION 


Setuname sets the values reported by uname. Options 
set the same things that they report in uname. 
Sysname, nodename, and release are truncated to eight 
characters. = 


Only the superuser can execute setuname successfully. 


SEE ALSO 
uname(1), uname(2). 
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NAME 
sh, rsh — shell, the standard/restricted command 
programming language 
SYNOPSIS 
sh { —acefhiknrstuvx | [ args | 
rsh | —acefhiknrstuvx | | args | 
DESCRIPTION 


Sh is a new version of the shell. It replaces the shell in a 
previous version of CTIX. Its new features include: 


e Functions: user-defined built-in commands. See 
Commands below. 


° Remembering both previously used and _ user- 
specified executable files in a hash table. See 
Execution and Spectal Commands (for the hash 
command) below. 


° New parameters for mail checking and 
accounting. See Parameter Substitution below. 


Definitions 
A blank is a tab or a space. A name is a sequence of 
letters, digits, or underscores beginning with a letter or 
underscore. A parameter is a name, a digit, or any of 
the characters *, @, #, ?, —, $, and!. 


Commands 

A stmple-command is a sequence of non-blank words 
separated by blanks. The first word specifies the name 
of the command to be executed. Except as specified 
below, the remaining words are passed as arguments to 
the invoked command. The command name is passed as 
argument O (see ezec(2)). The value of a simple- 
command is its exit status if it terminates normally, or 
(octal) 200+status if it terminates abnormally (see 
stgnal(2) for a list of status values). 


A ptpeline is a sequence of one or more commands 
separated by | (or, for historical compatibility, by * 
The standard output of each command but the last is 
connected by a ptpe(2) to the standard input of the next 
command. Each command is run as a separate process; 
the shell waits for the last command to terminate. The 
exit status of a pipeline is the exit status of the last 
command. 


A list is a sequence of one or more pipelines separated by 
3, &, &&, or | |, and optionally terminated by ; or &. 
Of these four symbols, ; and & have equal precedence, 
which is lower than that of && and | |. The symbols 
&& and | | also have equal precedence. A semicolon (;) 
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causes sequential execution of the preceding pipeline; an 
ampersand 2 causes asynchronous execution of the 
preceding pipeline (i.e., the shell does not wait for that 
pipeline to finish). The symbol && (| | ) causes the list 
following it to be executed only if the preceding pipeline 
returns a zero (non-zero) exit status. An arbitrary 
number of new-lines may appear in a list, instead of 
semicolons, to delimit commands. 


A command is either a simple-command or one of the 
following. Unless otherwise stated, the value returned by 
a command is that of the last simple-command executed 
in the command. 


for name | in word ... | do list done 
Each time a for command is executed, name is 
set to the next word taken from the in word list. 
If in word ... is omitted, then the for 
command executes the do [ist once for each 
positional parameter that is set (see Parameter 
Substitution below). Execution ends when there 
are no more words in the list. 

case word in| pattern | | pattern |...) lst 3; 

esac 
A case command executes the list associated 
with the first pattern that matches word. The 
form of the patterns is the same as that used for 
filename generation (see File Name Generation ) 
except that a slash, a leading dot, or a dot 
immediately following a slash need not be 
matched explicitly. 

if list then list | elif list then list ]...[ else list | fi 
The list following if is executed and, if it returns 
a zero exit status, the list following the first 
then is executed. Otherwise, the list following 
elif is executed and, if its value is zero, the list 
following the next then is executed. Failing 
that, the else list is executed. If no else /tst or 
then itst is executed, then the if command 
returns a zero exit status. 

while list do l1st done 
A while command repeatedly executes the while 
list and, if the exit status of the last command 
in the list is zero, executes the do list; otherwise 
the loop terminates. If no commands in the do 
list are executed, then the while command 
returns a zero exit status; until may be used in 
place of while to negate the loop termination 
test. 
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(list) 
Execute list in a sub-shell. 

{list;} 
list is simply executed. 

name () {list;} 
Define a function which is referenced by name. 
The body of the function is the list of commands 
between { and }. Execution of functions is 
described below (see Execution ). 


The following words are only recognized as the first, word 
of a command and when not quoted: 


if then else elif fi case esac for while 
until do done { 


Comments 
A word beginning with # causes that word and all the 
following characters up to a new-line to be ignored. 


Command Substitution 
The standard output from a command enclosed in a pair 
of grave accents {**) may be used as part or all of a 
word; trailing new-lines are removed. 


Parameter Substitution 
The character $ is used to introduce substitutable 
parameters. There are two types of parameters, 
positional and keyword. If parameter is a digit, it is a 
positional parameter. Positional parameters may be 
assigned values by set. Keyword parameters (also 
known as variables) may be assigned values by writing: 


name=value | name=value |... 


Pattern-matching is not performed on value. There 
cannot be a function and a variable with the same 
name . 


${parameter } 
The value, if any, of the parameter is 
substituted. The braces are required only when 
parameter is followed by a letter, digit, or 
underscore that is not to be interpreted as part 
of its name. If parameter is * or @, all the 
positional parameters, starting with $1, are 
substituted (separated by spaces). Parameter $0 
is set from argument zero when the shell is 
invoked. 

${parameter:—word } 
If parameter is set and is non-null, substitute its 
value; otherwise substitute word. 

${parameter:—=word } 
If parameter is not set or is null set it to word; 
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the value of the parameter is substituted. 
Positional parameters may not be assigned to in 
this way. 
${parameter:?word} 
If parameter is set and is non-null, substitute its 
value; otherwise, print word and exit from the 
shell. If word is omitted, the message 
“parameter null or not set” is printed. 
${parameter:+ word} 
f parameter is set and is non-null, substitute 
word; otherwise substitute nothing. 


In the above, word is not evaluated unless it is to be 
used as the substituted string, so that, in the following 
example, pwd is executed only if d is not set or is null: 


echo ${d:— \ pwd * } 


If the colon (:) is omitted from the above expressions, the 
shell only checks whether parameter is set or not. 


The following parameters are automatically set by the 

shell: 

Fg The number of positional parameters in decimal. 

~ Flags supplied to the shell on invocation or by 
the set command. 


? The decimal value returned by the last 
synchronously executed command. 

$ The process number of this shell. 

! The process number of the last background 


command invoked. 
The following parameters are used by the shell: 


HOME The default argument (home directory) 
for the ed command. 
PATH The search path for commands (see 


Execution below). The user may not 
change PATH if executing under rsh. 

CDPATH The search path for the ed command. 

MAIL If this parameter is set to the name of a 
mail file and the MAILPATH 
parameter is not set, the shell informs 
the user of the arrival of mail in the 
specified file. 

MAILCHECK This parameter specifies how often a. 
seconds) the shell will check for the 
arrival of mail in the files specified by 
the MAILPATH or MAIL parameters. 
The default value is 600 seconds (10 
minutes). If set to 0, the shell will 
check before each prompt. 
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MAILPATH _ A colon (:) separated list of file names. 
this parameter is set, the shell 
informs the user of the arrival of mail 
in any of the specified files. Each file 
name can be followed by % and a 
message that will be printed when the 
modification time changes. The default 
message is you have mail. 


PS1 Primary prompt string, by default $. 

PS2 Secondary prompt string, by default >. 

IFS Internal field separators, normally 
space, tab, and new-line. 

SHACCT If this parameter is set to the name of a 


file writable by the user, the shell will 
write an accounting record in the file 
for each shell procedure executed. 
Accounting routines such as acctcom (1) 
and acctems(1M) can be used to 
analyze the data collected. 

SHELL When the shell is invoked, it scans the 
environment (see Environment below) 
for this name. If it is found and there 
is an ’r’ in the file name part of its 
vane the shell becomes a restricted 
shell. 


The shell gives default values to PATH, PS1, PS2, 
lee and IFS. HOME and MAIL are set by 
login(1). 


Blank Interpretation 


File 


After parameter and command substitution, the results 
of substitution are scanned for internal field separator 
characters (those found in IFS) and split into distinct 
arguments where such characters are found. Explicit 
null arguments ("” or ’ 7%) are retained. Implicit null 
arguments (those resulting from parameters that have no 
values) are removed. 


Name Generation 

Following substitution, each command word is scanned 
for the characters *, ?, and [. If one of these characters 
appears, the word is regarded as a pattern. The word is 
replaced with alphabetically sorted file names that 
match the pattern. If no file name is found that matches 
the pattern, the word is left unchanged. The character . 
at the start of a file name or immediately following a /, 
as well as the character / itself, must be matched 
explicitly. 
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* Matches any string, including the null 
string. 

7 Matches any single character. 

[...] Matches any one of the enclosed 
characters. A pair of characters 


separated by — matches any character 
lexically between the pair, inclusive. If 
the first character following the opening 
[ is a !, any character not enclosed is 
matched. 


Quoting 


The following characters have a special meaning to the 
shell and cause termination of a word unless quoted: 


; &()| * < > new-line space tab 


A character may be quoted (i.e., made to stand for itself) 
by preceding it with a \. The pair \new-line is ignored. 
All characters enclosed between a pair of single quote 
marks ( ” ”), except a single quote, are quoted. Inside 
double quote marks (””), parameter and command 
substitution occurs and \ quotes the characters \, *, ”, 
and $. “$*#" is equivalent to "$1 $2 ...", whereas 
"$@* is equivalent to "$1" "$2" .... 


Prompting 


When used interactively, the shell prompts with the 
value of PS1 before reading a command. If at any time 
a new-line is typed and further input is needed to 
complete a command, the secondary prompt (ie., the 
value of PS2) is issued. 


Input/Output 


Before a command is executed, its input and output may 
be redirected using a special notation interpreted by the 
shell. The following may appear anywhere in a simple- 
command or may precede or follow a command and are 
not passed on to the invoked command; substitution 
occurs before word or digtt is used: 


<word Use file word as standard input (file 
descriptor 0). 
>word Use file word as standard output (file 


descriptor 1). If the file does not exist, it 
is created; otherwise, it is truncated to 
zero length. 

> >word Use file word as standard output. If the 
file exists output is appended to it (by 
first seeking to the — end-of-file); 
otherwise, the file is created. 
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<<[-—|word The shell input is read up to a line that 
is the same as word, or to an end-of-file. 
The resulting document becomes the 
standard input. If any character of word 
is quoted, no interpretation is placed 
upon the characters of the document; 
otherwise, parameter and command 
substitution occurs, (unescaped) \new- 
line is ignored, and \ must be used to 
quote the characters \, $, *, and the first 
character of word. If — is appended to 
<<, all leading tabs are stripped from 
word and from the document. 

<&digit The standard input is duplicated from 
file descriptor digit (see dup(1)). 
Similarly for the standard output using 


>. 
<&- The standard input is closed. Similarly 
for the standard output using >. 


If any of the above is preceded by a digit, the file 
descriptor which will be associated with the file is that 
specified by the digit (instead of the default 0 or 1). For 
example: 


... 2>&1 


associates file descriptor 2 with the file currently 
associated with file descriptor 1. 


The order in which redirections are specified is 
significant. The shell evaluates redirections left-to-right. 
For example: 


. l>2zer 2>&1 


first associates file descriptor 1 with file zzz. It 
associates file descriptor 2 with the file associated with 
file descriptor 1 (ie. zzz). If the order of redirections 
were reversed, file descriptor 2 would be associated with 
the terminal (assuming file descriptor 1 had been) and 
file descriptor 1 would be associated with file rzz. 


If a command is followed by &, the default standard 
input for the command is the empty file /dev/null. 
Otherwise, the environment for the execution of a 
command contains the file descriptors of the invoking 
shell as modified by input/output specifications. 


Redirection of output is not allowed in the restricted 
shell. 


Environment 
The environment (see environ(5)) is a list of name-value 
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pairs that is passed to an executed program in the same 
way as 3 normal argument list. The shell interacts with 
the environment in several ways. On invocation, the 
shell scans the environment and creates a parameter for 
each name found, giving it the corresponding value. If 
the user modifies the value of any of these parameters or 
creates new parameters, none of these affects the 
environment unless the export command is used to bind 
the shell’s parameter to the environment (see also set 
—a). A parameter may be removed from the 
environment with the unset command. The 
environment seen by any executed command is thus 
composed of any unmodified name-value pairs originally 
inherited by the shell, minus any pairs removed by 
unset, plus any modifications or additions, all of which 
must be noted in export commands. 


The environment for any stmple-command may be 
augmented by prefixing it with one or more assignments 
to parameters. Thus: 


TERM=450 cmd 
and 
(export TERM; TERM==450; cmd) 


are equivalent (as far as the execution of cmd is 
concerned). 


If the —k flag is set, all keyword arguments are placed in 
the environment, even if they occur after the command 
name. The following first prints a==b c and c: 


echo a=b c 
set ~—k 
echo a=b c 


Signals 
The INTERRUPT and QUIT signals for an invoked 
command are ignored if the command is followed by &; 
otherwise signals have the values inherited by the shell 
from its parent, with the exception of signal 11 (but see 
also the trap command below). 


Execution 
Each time a command is_ executed, the above 
substitutions are carried out. If the command name 
matches one of the Special Commands listed below, it is 
executed in the shell process. If the command name does 
not match a Spectal Command , but matches the name of 
a defined function, the function is executed in the shell 
process (note how this differs from the execution of shell 
procedures). The positional parameters $1, $2,.... are 
set to the arguments of the function. If the command 
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name matches neither a Spectal Command nor the name 
of a defined function, a new process is created and an 
attempt is made to execute the command via ezec(2). 


The shell parameter PATH defines the search path for 
the directory containing the command. Alternative 
directory names are separated by a colon (:). The 
default path is :/bin:/usr/bin (specifying the current 
directory, /bin, and /usr/bin, in that order). Note 
that the current directory is specified by a null path 
name, which can appear immediately after the equal sign 
or between the colon delimiters anywhere else in the 
path list. If the command name contains a / the search 
path is not used; such commands will not be executed by 
the restricted shell. Otherwise, each directory in the 
path is searched for an executable file. If the file has 
execute permission but is not an a.out file, it is assumed 
to be a file containing shell commands. A sub-shell is 
spawned to read it. A parenthesized command is also 
executed in a sub-shell. 


The location in the search path where a command was 
found is remembered by the shell (to help avoid 
unnecessary ezecs later). If the command was found in 
a relative directory, its location must be re-determined 
whenever the current directory changes. The shell 
forgets all remembered locations whenever the PATH 
variable is changed or the hash —r command is executed 
(see below). 


Special Commands 
Input/output redirection is now permitted for these 
commands. File descriptor 1 is the default output 
location. 


No effect; the command does nothing. A zero 
exit code is returned. 

. file Read and execute commands from file and 
return. The search path specified by PATH is 
used to find the directory containing file. 

break [ 1 | 
Exit from the enclosing for or while loop, if 
any. If n is specified break n levels. 

continue [ n 
Resume the next iteration of the enclosing for or 
while loop. If n is specified, resume at the n-th 
enclosing loop. 

ed[ arg | 
Change the current directory to arg. The shell 
parameter HOME is the default arg. The shell 
parameter CDPATH defines the search path for 
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the directory containing arg. Alternative 
directory names are separated by a colon (:). 
The default path is <null> (specifying the 
current directory). Note that the current 
directory is specified by a null path name, which 
can appear immediately after the equal sign or 
between the colon delimiters anywhere else in 
the path list. If arg begins with a /, the search 
path is not used. Otherwise, each directory in 
the path is searched for arg. The ed command 
may not be executed by rsh. 

echo [{ arg... | 
Echo arguments. See echo(1) for usage and 
description. 

eval [ arg... 
The arguments are read as input to the shell and 
the resulting command(s) executed. 

exec [ arg... | 
The command specified by the arguments is 
executed in place of this shell without creating a 
new process. Input/output arguments may 
appear and, if no other arguments are given, 
cause the shell input/output to be modified. 

exit | n 
Causes a shell to exit with the exit status 
specified by n. If n is omitted, the exit status is 
that of the last command executed (an end-of- 
file will also cause the shell to exit.) 

export seme ik Al 

he given names are marked for automatic 

export to the environment of subsequently- 
executed commands. If no arguments are given, 
a list of all names that are exported in this shell 
is printed. Function names may not be 
exported. 

hash [| -r ][ name... 
For each name, the location in the search path 
of the command specified by name is determined 
and remembered by the shell. The —r option 
causes the shell to forget all remembered 
locations. If no arguments are given, 
information about remembered commands is 
presented. Hits is the number of times a 
command has been invoked by the shell process. 
Cost is a measure of the work required to locate 
a command in the search path. There are 
certain situations which require that the stored 
location of a command be _ recalculated. 
Commands for which this will be done are 
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indicated by an asterisk (*) adjacent to the hits 
information. Cost will be incremented when the 
recalculation is done. 


newerD | arg... | 


pwd 


read [ 


quivalent to exec newgrp arg .... See 
newgrp(1) for usage and description. 
Print the current working directory. See pwd(1) 
for usage and description. 
name... 
One line is read from the standard input and the 
first word is assigned to the first name, the 
second word to the second name, etc., with 
leftover words assigned to the last name. The 
return code is O unless an_ end-of-file is 
encountered. 


readonly { name... | 


return 


The given names are marked readonly and the 
values of the these names may not be changed 
by subsequent assignment. If no arguments are 
ea a list of all readonly names is printed. 
n 

Causes a function to exit with the return value 
specified by n. If n is omitted, the return status 
is that of the last command executed. 


set | —-aefhkntuvx [ arg... | ] 


—a Mark variables which are modified or 
created for export. 

-e Exit immediately if a command exits 
with a non-zero exit status. 

-f Disable file name generation 

-h Locate and remember function 


commands as functions are defined 
(function commands are normally 
located when the function is executed). 
-k All keyword arguments are placed in the 
environment for a command, not just 
those that precede the command name. 


—n Read commands but do not execute 
them. 

—t Exit after reading and executing one 
command. 

—u Treat unset variables as an error when 
substituting. 

-v Print shell input lines as they are read. 

~x Print commands and their arguments as 


they are executed. 
-- Do not change any of the flags; useful in 
setting $1 to —. 
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Using + rather than — causes these flags to be 
turned off. These flags can also be used upon 
invocation of the shell. The current set of flags 
may be found in $—. The remaining arguments 
are positional parameters and are assigned, in 
order, to $1, $2, .... If no arguments are 
given, the values of all names are printed. 

n 


The positional parameters from $n+1... are 
renamed $1.... If n is not given, it is assumed 
to be 1. 


Evaluate conditional expressions. See test(1) for 
usage and description. 


Print the accumulated user and system times for 
processes run from the shell. 

arg |[ nn]... 

The command arg is to be read and executed 
when the shell receives signal(s) n. (Note that 
arg is scanned once when the trap is set and 
once when the trap is taken.) Trap commands 
are executed in order of signal number. Any 
attempt to set a trap on a signal that was 
ignored on entry to the current shell is 
ineffective. An attempt to trap on signal 11 
(memory fault) produces an error. If arg is 
absent, all trap A n are reset to their original 
values. If arg is the null string, this signal is 
ignored by the shell and by the commands it 
invokes. If n is 0, the command arg is executed 
on exit from the shell. The trap command with 
no arguments prints a list of commands 
associated with each signal number. 

name... 

For each name, indicate how it would be 
interpreted if used as a command name. 


ulimit | -f 


n 

imposes a size limit of n 

-f imposes a size limit of n blocks on files 
written by child processes (files of any 
size may be read). With no argument, 
the current limit is printed. 

If no option is given, ~f is assumed. 


umask pone | 


he user file-creation mask is set to nnn (see 
umask(2)). If nnn is omitted, the current value 
of the mask is printed. 
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unset [| name... | 
For each name, remove the corresponding 
variable or function. The variables PATH, PS1, 
PS2, MAILCHECK and IFS cannot be unset. 
wait [ n 
Wait for the specified process and report its 
termination status. If n is not given, all 
currently active child processes are waited for 
and the return code is zero. 


Invocation 

If the shell is invoked through ezec(2) and the first 
character of argument zero is —, commands are initially 
read from /ete/profile and from $HOME/.profile, if 
such files exist. Thereafter, commands are read as 
described below, which is also the case when the shell is 
invoked as /bin/sh. The flags below are interpreted by 
the shell on invocation only. Note that unless the ~e or 
—s flag is specified, the first argument is assumed to be 
the name of a file containing commands, and the 
remaining arguments are passed as positional parameters 
to that command file: 


—c string If the —c flag is present, commands are read 
from string. 

-s If the —s flag is present or if no arguments 
remain, commands are read from the 
standard input. Any remaining arguments 
specify the positional parameters. Shell 
output (except for Spectal Commands ) is 
written to file descriptor 2. 

-i If the ~i flag is present or if the shell input 
and output are attached to a terminal, this 
shell is interactive. In this case TERMINATE 
is ignored (so that kill O does not kill an 
interactive shell) and INTERRUPT is caught 
and ignored (so that wait is interruptible). 
In all cases, QUIT is ignored by the shell. 

-r If the —r flag is present the shell is a 
restricted shell. 


The remaining flags and arguments are described under 
the set command above. 


Rsh Only 
Reh is used to set up login names and execution 
environments whose capabilities are more controlled than 
those of the standard shell. The actions of rsh are 
identical to those of sh, except that the following are 
disallowed: 
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changing directory (see cd(1)), 

setting the value of $PATH, 

specifying path or command names containing /, 
redirecting output (> and >>). 


The restrictions above are enforced after .profile is 
interpreted. 


When a command to be executed is found to be a shell 
procedure, rsh invokes sh to execute it. Thus, it is 
possible to provide to the end-user shell procedures that 
have access to the full power of the standard shell, while 
imposing a limited menu of commands; this scheme 
assumes that the end-user does not have write and 
execute permissions in the same directory. 


The net effect of these rules is that the writer of the 
-profile has complete control over user actions, by 
performing guaranteed setup actions and leaving the user 
in an appropriate directory (probably not the login 
directory 


The system administrator often sets up a directory of 
commands (i.e., /usr/rbin) that can be safely invoked 
by rsh. Some systems also provide a restricted editor 
red. 


EXIT STATUS 


FILES 


Errors detected by the shell, such as syntax errors, cause 
the shell to return a non-zero exit status. If the shell is 
being used non-interactively execution of the shell file is 
abandoned. Otherwise, the shell returns the exit status 
of the last command executed (see also the exit 
command above). 


/etc/profile 
$HOME prot ile 
/tmp/s 

/dev/ pil 


SEE ALSO 


NOTE 


acctcom(1), ail nae (nee esh(1), echo{1), env 
expr(1), login(1), new , pwd(1), test 1), uk 
dup(2), exec(2), fork ep pipe(2), este , ulimit(2), 
umask(2), wait. 2), a.out(4), Pia) environ(5). 


If the first character in an executable file is #, csh 
assumes that the file is a esh script. For compatibility 
with csh, it is recommended that sh scripts begin with a 
blank line. 
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WARNINGS 
If a command is executed, and a command with the 
same name is installed in a directory in the search path 
before the directory where the original command was 
found, the shell will continue to ezec the original 
command. Use the hash command to correct this 
situation. 


If you move the current directory or one above it, pwd 
may not give the correct response. Use the ed command 
with a full path name to correct this situation. 
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NAME 

shl — shell layer manager 
SYNOPSIS 

shl 
DESCRIPTION 


Shl allows a user to interact with more than one shell 
from a single terminal. The user controls these shells, 
known as layers , using the commands described below. 


The current layer is the layer which can receive input 
from the keyboard. Other layers attempting to read 
from the keyboard are blocked. Output from multiple 
layers is multiplexed onto the terminal. To have the 
output of a layer blocked when it is not current, the sity 
option loblk may be set within the layer. 


The stty character swtch (set to *Z if NUL) is used to 
switch control to shi from a layer. Shi has its own 
prompt, >>>, to help distinguish it from a layer. 


A layer is a shell which has been bound to a virtual tty 
device (/dev/sxt???). The virtual device can be 
manipulated like a real tty device using stty(1) and 
toctl(2). Each layer has its own process group id. 


Definitions 


A name is a sequence of characters delimited by a blank, 
tab or new-line. Only the first eight characters are 
significant. The names (1) through (7) cannot be used 
when creating a layer. They are used by shi when no 
name is supplied. They may be abbreviated to just the 
digit. 


Commands 


The following commands may be issued from the shl 
prompt level. Any unique prefix is accepted. 


create [ name | 
Create a layer called name and make it the 
current layer. If no argument is given, a layer 
will be created with a name of the form (#) 
where # is the last digit of the virtual device 
bound to the layer. The shell prompt variable 
PS1 is set to the name of the layer followed by a 
space. A maximum of seven layers can be 
created. 

block name [ name ... | 
For each name, block the output of the 
corresponding layer when it is not the current 
layer. This is equivalent to setting the stty 
option —loblk within the layer. 
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delete name [| name... | 
For each name, delete the corresponding layer. 
All processes in the process group of the layer 
are sent the SIGHUP signal (see stgnal(2)). 

help (or ?) 
Print the syntax of the shi commands. 

layers | —1 ][ name... 
For each name, list the layer name and its 
process group. The —I option produces a ps(1)}- 
like listing. If no arguments are given, 
information is presented for all existing layers. 

resume { name 
Make the layer referenced by name the current 
layer. If no argument is given, the last existing 
current layer will be resumed. 

toggle Resume the layer that was current before the 
last current layer. 

unblock name { name... 
For each name, do not block the output of the 
corresponding layer when it is not the current 
layer. This is equivalent to setting the sity 
option ~loblk within the layer. 

quit Exit shi. All layers are sent the SIGHUP signal. 

name Make the layer referenced by name the current 


layer. 
FILES 
/dev/sxt/??? Virtual tty devices 
$SHELL Variable containing path name of 
the shell to use (default is /bin/sh). 
/etc/drvload 
SEE ALSO 


NOTE 


sh(1), stty(1), ioctl(2), signal(2), sxt(7). 
MightyFrame Administrator’s Reference Manual. 


The szt driver must be loaded before shi can be used. 


SHUTDOWN (1M) 


NAME 

shutdown, halt — terminate all processing 
SYNOPSIS 

/etc/shutdown [ grace | 

/ete/halt 
DESCRIPTION 


Shutdown shuts down CTIX in an orderly manner. It 
cautiously terminates all currently running processes. 
The procedure is designed to interact with the operator 
(i.e., the person who invoked shutdown). Shutdown may 
instruct the operator to perform some specific tasks, or 
to supply certain responses before execution can resume. 
Shutdown goes through the following steps: 


All users logged on the system are notified to log off 
the system by a broadcasted message. The operator 
may display his/her own message at this time. 
Otherwise, the standard file save message is 
displayed. User’s are given grace seconds (default 
60). to log out on their own. 


If the operator wishes to run the file-save procedure, 
shutdown unmounts all file systems. 


All file systems’ super blocks are updated before the 
system is to be stopped (see sync(1)). This must be 
done before re-booting the system, to insure file 
system integrity. 
Halt shuts down CTIX in a safe but abrupt way. It is 
meant for small installations where verbal warnings are 
faster than terminal messages. 


DIAGNOSTICS 
The most common error diagnostic that will occur is 
device busy. This diagnostic happens when a particular 
file system could not be unmounted. 


SEE ALSO 
mount(1M), sync(1), update(1M). 
MightyFrame Administrator’s Reference Manual. 
MiniFrame Administrator’s Manual. 
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size — print section sizes of common object files 


SYNOPSIS 


size [—o] [-x] [—V] files 


DESCRIPTION 


The size command produces section size information for 
each section in the common object files. The size of the 
text, data and bss (uninitialized data) sections are 
printed along with the total size of the object file. If an 
archive file is input to the stze command the information 
for all archive members is displayed. 


Numbers will be printed in decimal unless either the —o 
or the —x option is used, in which case they will be 
printed in octal or in hexadecimal, respectively. 

The —V flag will supply the version information on the 
size command. 


SEE ALSO 


as(1), cc(1), ld(1), a.out(4), ar(4). 


DIAGNOSTICS 


size: name: cannot open 
if name cannot be read. 


_ size: name: bad magic 
if name is not an appropriate 
common object file. 
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NAME 
slattach, sldetach — attach and detach serial lines as 
network interfaces 

SYNOPSIS 
etc/slattach devname source destination 

baudrate | 

/etc/sldetach interface-name 

DESCRIPTION 
Slattach is used to assign a serial (tty) line to a network 
interface using the DARPA Internet Protocol, and to 
define the source and destination network addresses. 
The devname parameter is the name of the device the 
serial line is attached to, e.g., /dev/tty001. The source 
and destination are either host names present in the host 
name data base (see hosts(4)), or DARPA Internet 
addresses expressed in the Internet standard ‘‘dot 
notation”. The optional baudrate parameter is used to 
set the speed of the connection; if not specified, the 
default of 9600 is used. 
Only the superuser may attach or detach a network 
interface. 
Sldetach is used to remove the serial line that is being 
used for IP from the network tables and allow it to be 
used as a normal terminal again. Interface-name is the 
name that is shown by netstat(1N); in general, an 
interface on ttyOzz will be referred to as slzz. 

EXAMPLES 
/etc/slattach tty001 tom-sre genstar 
/etc/slattach /dev/tty001 hugo dah! 4800 
/etc/sldetach sl01 

FILES 
/etc/hosts, /dev/* 

DIAGNOSTICS 
Various messages indicating: 
- the specified interface does not exist 
~ the requested address is unknown 
- the user is not the superuser 

SEE ALSO 


hosts(4), netstat(1N), ifconfig(1NM). 


SLEEP (1) 


NAME 
sleep — suspend execution for an interval 


SYNOPSIS 
sleep time 


DESCRIPTION 
Sleep suspends execution for time seconds. It is used to 
execute a command after a certain amount of time, as 
in: 
(sleep 105; command )& 


or to execute a command every so often, as in: 


while true 
do 
command 
sleep 37 
done 


SEE ALSO 
alarm(2), sleep(3C). 


BUGS 
Time must be less than 2,147,483,647 seconds. 
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NAME 
sort — sort and/or merge files 
SYNOPSIS 
sort {—cmu] —ooutput] -ykmem)] —_[~zgrecsz| 
[~dfiMnr] [—btx] |+-pos! {—pos2)] [files] 
DESCRIPTION 


Sort sorts lines of all the named files together and writes 
the result on the standard output. The standard input is 
read if — is used as a file name or no input files are 
named. 


Comparisons are based on one or more sort keys 
extracted from each line of input. By default, there is 
one sort key, the entire input line, and ordering is 
lexicographic by bytes in machine collating sequence. 


The following options alter the default behavior: 


—c Check that the input file is sorted according to the 
ordering rules; give no output unless the file is out 
of sort. 


—m Merge only, the input files are already sorted. 


—u Unique: suppress all but one in each set of lines 
having equal keys. 


—ooutput 
The argument given is the name of an output file 
to use instead of the standard output. This file 
may be the same as one of the inputs. There may 
be optional blanks between —o and output. 


-ykmem 

The amount of main memory used by the sort has 
a large impact on its performance. Sorting a small 
file in a large amount of memory is a waste. If this 
option is omitted, sort begins using a system 
default memory size, and continues to use more 
space as needed. If this option is presented with a 
value, kmem, sort will start using that number of 
kilobytes of memory, unless the administrative 
minimum or maximum is violated, in which case 
the corresponding extremum will be used. Thus, 
—y0 is guaranteed to start with minimum memory. 
By convention, —y (with no argument) starts with 
maximum memory. 


—zZrecsz 
The size of the longest line read is recorded in the 
sort phase so buffers can be allocated during the 
merge phase. If the sort phase is omitted via the 
-—¢ or —m options, a popular system default size 
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will be used. Lines longer than the buffer size will 
cause sort to terminate abnormally. Supplying the 
actual number of bytes in the longest line to be 
merged (or some larger value) will prevent 
abnormal termination. 


The following options override the default ordering rules. 


-d “Dictionary” order: only letters, digits and blanks 
(spaces and tabs) are significant in comparisons. 


-f Fold lower case letters into upper case. 


-i Ignore characters outside the ASCII range 040-0176 
in non-numeric comparisons. 


—M Compare as months. The first three non-blank 
characters of the field are folded to upper case and 
compared so that “JAN” < “FEB” < < 
“DEC”. Invalid fields compare low to “JAN”. The 
—M option implies the —b option (see below). 


—n_ An initial numeric string, consisting of optional 
blanks, optional minus sign, and zero or more 
digits with optional decimal point, is sorted by 
arithmetic value. The —n option implies the —b 
option (see below). Note that the —b option is 
only effective when restricted sort key 
specifications are in effect. 


-r Reverse the sense of comparisons. 


When ordering options appear before restricted sort key 
specifications, the requested ordering rules are applied 
globally to all sort keys. When attached to a specific 
sort key (described below), the specified ordering options 
override all global ordering options for that key. 


The notation +posi —pos2 restricts a sort key to one 


beginning at posl and ending at pos2. The characters at 
ositions pos! and pos? are included in the sort key 
(proved that pos2 does not precede posi). A missing 
—pos2 means the end of the line. 


Specifying posi and pos2 involves the notion of a field, a 
minimal sequence of characters followed by a field 
separator or a new-line. By default, the first blank 
(space or tab) of a sequence of blanks acts as the field 
separator. All blanks in a sequence of blanks are 
considered to be part of the next field; for example, all 
blanks at the beginning of a line are considered to be 
part of the first field. The treatment of field separators 
can be altered using the options: 
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—tr Use z as the field separator character; z is not 
considered to be part of a field (although it may be 
included in a sort key). Each occurrence of z is 
significant (e.g., zz delimits an empty field). 


-b Ignore leading blanks when determining the 
starting and ending positions of a restricted sort 
key. If the —b option is specified before the first 
+posi argument, it will be applied to all +pos1 
arguments. Otherwise, the b flag may be attached 
independently to each +posi1 or —pos2 argument 
(see below). 


Post and pos? each have the form m.n optionally 
followed by one or more of the flags bdfinr. A starting 
position specified by +m.n is interpreted to mean the 
n+lst character in the m+Ist field. A missing .n means 
-0, indicating the first character of the m+lIst field. If 
the b flag is in effect n is counted from the first non- 
blank in the m+Ist field; +m.0b refers to the first 
non-blank character in the m+Ist field. 


A last position specified by —m.n is interpreted to mean 
the nth character (including separators) after the last 
character of the m th field. A missing .n means .0, 
indicating the last character of the mth field. If the b 
flag is in effect n is counted from the last leading blank 
in the m+I1st field; —m.1b refers to the first non-blank 
in the m+Ist field. 


When there are multiple sort keys, later keys are 
compared only after all earlier keys compare equal. 
Lines that otherwise compare equal are ordered with all 
bytes significant. 


EXAMPLES 


Sort the contents of infile with the second field as the 
sort key: 


sort +1 —2 infile 


Sort, in reverse order, the contents of inftle1 and infile2, 
placing the output in outfile and using the first character 
of the second field as the sort key: 

sort —r —o outfile +1.0 —1.2 infilel infile2 
Sort, in reverse order, the contents of inftle1 and infile?2 
using the first non-blank character of the second field as 
the sort key: 


sort —r +1.0b —1.1b infilel infile2 


Print the password file (passwd(4)) sorted by the 
numeric user ID (the third colon-separated field): 
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sort —t: +2n —3 /etc/passwd 


Print the lines of the already sorted file infile, 
suppressing all but the first occurrence of lines having 
the same third field (the options -—um with just one 
input file make the choice of a unique representative 
from a set of equal lines predictable): 


sort —um +2 ~3 infile 


usr/tmp/stm??? 
/usr/tmp/ 


SEE ALSO 


comm(1), join(1), uniq(1). 


DIAGNOSTICS 


Comments and exits with non-zero status for various 
trouble conditions (e.g., when input lines are too long), 
and for disorder discovered under the —e option. When 
the last line of an input file is missing a new-line 
character, sort appends one, prints a warning message, 
and continues. 


NAME 
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spell, hashmake, spellin, hashcheck ~— find spelling errors 


SYNOPSIS 


spe -v | [| -b 
| +local_file | [ files ] 


/usr/lib/spell/hashmake 
/usr/lib/spell/spellin n 
/usr /lib/spell/hashcheck spelling_list 


DESCRIPTION 


Spell collects words from the named files and looks them 
up in a spelling list. Words that neither occur among 
nor are derivable (by applying certain inflections, 
prefixes, and/or suffixes) from words in the spelling list 
are printed on the standard output. If no files are 
named, words are collected from the standard input. 


Spell ignores most froff(1), tb/(1), and egn(1) 
constructions. 


Under the —v option, all words not literally in the 
spelling list are printed, and plausible derivations from 
the words in the spelling list are indicated. 


Under the —b option, British spelling is checked. Besides 
preferring centre, colour, programme,  spectality, 
travelled, etc., this option insists upon -tse in words like 
standardise, Fowler and the OED to the contrary 
notwithstanding. 


Under the —x option, every plausible stem is printed 
with == for each word. 


By default, spell (like deroff(1)) follows chains of 
included files (.so and .nx troff(1) requests), unless the 
names of such included files begin with /usr/lib. Under 
the ~1 option, spell will follow the chains of all included 
files. Under the —i option, spell will ignore all chains of 
included files. 


Under the +local_file option, words found in local_file 
are removed from spell’s output. Local_file is the name 
of a user-provided file that contains a sorted list of 
words, one per line. With this option, the user can 
specify a set of words that are correct spellings (in 
addition to spell’s own spelling list) for each job. 


The spelling list is based on many sources, and while 
more haphazard than an ordinary dictionary, is also 
more effective with respect to proper names and popular 
technical words. Coverage of the = specialized 
vocabularies of biology, medicine, and chemistry is light. 
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Pertinent auxiliary files may be specified by name 
arguments, indicated below with their default settings 
(see FILES). Copies of all output are accumulated in the 
history file. The stop list filters out misspellings (e.g., 
thier=thy-y-+ier) that would otherwise pass. 


Three routines help maintain and check the hash lists 
used by spell: 


hashmake Reads a list of words from the standard 
input and writes the corresponding nine- 
digit hash code on the standard output. 


spellin n Reads n sorted hash codes from the 
standard input and writes a compressed 
spelling list on the standard output. 
Information about the hash coding is 
printed on standard error. 


hashcheck Reads a compressed spelling_fist and 
recreates the nine-digit hash codes for all 
the words in it; it writes these codes on 
the standard output. 


EXAMPLES 


The following example creates the hashed spell list hlist 
and checks the result by comparing the two temporary 
files; they should be equal. 


cat goodwds | /usr/lib/spell/hashmake | sort -u >tmpl 
cat tmpl | /usr/lib/spell/spellin ‘cat tmpl | we —1* 
> hlist 

cat hlist | /usr/lib/spell/hashcheck >tmp2 

diff tmp1 tmp2 


FILES 
D_SPELL=/usr/lib/spell/hlist{ab] | hashed spelling 
lists, American & 
British 
S_SPELL= /usr/lib/spell /hstop hashed stop list 
H_SPELL=/usr/lib/spell/spellhist history file 
/usr/lib/spell/spellprog program 
SEE ALSO 
deroff(1), eqn(1), sed(1), sort(1), tbl(1), tee(1), troff(1). 
BUGS 


The spelling list’s coverage is uneven; new installations 
will probably wish to monitor the output for several 
months to gather local additions; typically, these are 
kept in a separate local file that is added to the hashed 
spelling_list via spellin. 

The British spelling feature was done by an American. 


NAME 
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spline — interpolate smooth curve 


SYNOPSIS 


spline [ options | 


DESCRIPTION 


Spline takes pairs of numbers from the standard input as 
abscissas and ordinates of a function. It produces a 
similar set, which is approximately equally spaced and 
includes the input set, on the standard output. The 
cubic spline output (R. W. Hamming, Numerical 
Methods for Sctentists and Engineers, 2nd ed., pp. 349ff) 
has two continuous derivatives, and sufficiently many 
points to look smooth when plotted, for example by 
graph(1G). 


The following options are recognized, each as a separate 
argument: 


—a Supply abscissas automatically (they are missing 
from the input); spacing is given by the next 
argument, or is assumed to be 1 if next 
argument is not a number. 


-k The constant k used in the boundary value 
computation: - ; S 
Yo = Ayr, on = hyn 
is set by the next argument (default k = 0). 
—n Space output points so that approximately n 
intervals occur between the lower and upper z 
limits (default n = 100). 


=) Make output periodic, i.e., match derivatives at 
ends. First and last input values should 
normally agree. 


-x Next 1 (or 2) arguments are lower (and upper) z 
limits. Normally, these limits are calculated 
from the data. Automatic abscissas start at 
lower limit (default 0). 


SEE ALSO 


graph(1G). 


DIAGNOSTICS 


BUGS 


hen data is not strictly monotone in 2, spline 
reproduces the input without interpolating extra points. 


A limit of 1,000 input points is enforced silently. 
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NAME 

split — split a file into pieces 
SYNOPSIS 

split { —n | { file { name ] | 
DESCRIPTION 


Split reads file and writes it in n-line pieces (default 1000 
lines) onto a set of output files. The name of the first 
output file is name with aa appended, and so on 
lexicographically, up to zz (a maximum of 676 files). 
Name cannot be longer than 12 characters. If no output 
name is given, x is default. 

If no input file is given, or if — is given in its stead, then 
the standard input file is used. 


SEE ALSO 
bfs(1), csplit(1). 


STAT(1G) 


NAME 
stat - statistical network useful with graphical 
commands 

SYNOPSIS 
node-name [options] [files] 

DESCRIPTION 


Stat is a collection of command level functions (nodes) 
that can be interconnected using sh(1) to form a 
statistical network. The nodes reside in /usr/bin/graf 
(see graphtcs(1G)). Data is passed through the network 
as sequences of numbers (vectors), where a number is of 
the form: 
[sign|(digits)(.digits)[e[sign|digits] 

evaluated in the usual way. Brackets and parentheses 
surround fields. All fields are optional, but at least one 
of the fields surrounded by parentheses must be present. 
Any character input to a node that is not part of a 
number is taken as a delimiter. 


Stat nodes are divided into four classes. 


Transformers, which map input vector 
elements into output vector 
elements; 

Summaritzers, which calculate statistics of 
a vector; 

Translators, which convert among 


formats; and 


Generators, which are sources. of 
definable vectors. 


Below is a list of synopses for stat nodes. Most nodes 
accept options indicated by a leading minus (—). In 
general, an option is specified by a character followed by 
a value, such as c5. This is interpreted as ¢ := 5 (c is 
assigned 5). The following keys are used to designate 
the expected type of the value: 


c characters, 

t integer, 

f floating point or integer, 
file file name, and 


string string of characters, surrounded by quotes 
to include a Shell argument delimiter. 
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Options without keys are flags. All nodes except 
generators accept files as input, hence it is not indicated 
in the synopses. 


Transformers: 
abs 
af 


ceil 
cusum 
exp 
floor 
gamma 
list 


log 
mod 
pair 
power 
root 


round 


siline 


sin 
subset 


—cet| — absolute value 
columns (similarly for —¢ options that 
follow} 


{-ct tv |] — arithmetic function 
titled output, verbose 


[ —e#] — round up to next integer 


[ —e#] — cumulative sum 
—ci]| — exponential 
[ —e#] — round down to next integer 
—et| — gamma 
—cet dstring | — list vector elements 
delimiter(s) 


~ct bf | — logarithm 

base 

—ct mf |] - modulus 

modulus 

—ct F file xi] — pair elements 

ile containing base vector, x group size 





[-ct pf | — raise to a power 
power 

[-etrf | — take a root 
root 


[-ct pt st | — round to nearest integer, 
.5 rounds to 1 

places after decimal point, 

significant digits 

[-ctifnisf |] - generate a line given 
slope and intercept 

intercept, mumber of positive integers, 
slope 

{ et] - sine 

[—af bf ct Ffile it If nl np pf si tt] - 
generate a subset 

above, below, File with master vector, 
interval, leave, master contains element 
numbers to leave, master contains 
element numbers to pick, pick, start, 
terminate 
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bucket joes et Fftle hf it If nt] — break into 


cor 


hilo 


lreg 


mean 


point 


prod 
qsort 
rank 
total 
var 
Translators: 
bar 


hist 


uckets 
average size, File containing bucket 
boundaries, high, interval, low, number 
ae data should be sorted 


—F file | — correlation coefficient 
fie containing base vector 


{[~ h 1 0 ox oy J- find high and low 
values 
high only, low only, option form, option 
form with x prepended, option form with 
y prepended 
pene ios | — linear regression 

ile containing base vector, intercept 
only, option form for stline, slope only 


{- nips ] — (trimmed) arithmetic mean 
raction, number, percent 

[-ff nt pfs | - point from empirical 
cumulative density function 

fraction, number, percent, sorted input 


— internal product 
[~et] - quick sort 
— vector rank 

— sum total 

— variance 


[-abfgriwixfxayf yaylfyhf | 
— build a bar chart 

suppress axes, bold, suppress frame, 
suppress grid, region, width in percent, x 
origin, suppress x-axis label, y origin, 
suppress y-axis label, y-axis lower bound, 
y-axis high bound 

Data is rounded off to integers. 


-abfgrixfxayf yaylf yhf | - 
uild a histogram 

suppress axes, bold, suppress frame, 
suppress grid, region, x origin, suppress 
x-axis label, y origin, suppress y-axis 
label, y-axis lower bound, y-axis high 
bound 


label 


pie 


plot 


title 


Generators: 
gas 


prime 


rand 


RESTRICTIONS 
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[-—be Ffile h prt x xuy yr | ~ label 
the axis of a GPS file 

bar chart input, retain case, label File, 
histogram input, plot input, rotation, x- 
axis, upper x-axis, y-axis, right y-axis 


[-bop pnt ppt ri v xt yt | — builda 


pie chart 

bold, values outside pie, value as 
percentage(:—=100), value as 
percentage :=i), draw percent of pie, 


region, no values, x origin, y origin 
Unlike other nodes, input is lines of the 
form 
|< ie fcc >] value [label] 
ignore (do not draw) slice, explode 
slice, fill slice, color slice ¢ = ( 
black, red, green, blue) 


[-a b estring df Ffile g mri xf xa 
xif xhf xlf xmtxt yf ya yif yhf 
ylf yni yt | - plot a graph 

suppress axes, bold, plotting characters, 
disconnected, suppress frame, _ File 
containing x vector, suppress grid, mark 
oints, region, x origin, suppress x-axis 
abel, x interval, x high bound, x low 
bound, number of ticks on x-axis, 
suppress x-axis title, y origin, suppress y- 
axis label, y interval, y high bound, y 
low bound, number of ticks on y-axis, 
suppress y-axis title 


[—-b ¢ Istring vatring ustring | — title 
a vector or a GPS 
title bold, retain case, lower title, upper 
title, vector title 


[—et if nt sf tf] - generate additive 
sequence 
interval, number, start, terminate 


{et hi lint | — generate prime numbers 
igh, low, number 

[-et hf lf mf nist] — generate random 
sequence 

high, low, multiplier, number, seed 


Some nodes have a limit on the size of the input vector. 


STAT(1G) 


SEE ALSO 
graphics(1G), strtod(3C), gps(4). 


STRINGS (1) 


NAME 
strings — extract the ASCII text strings in a file 
SYNOPSIS 
strings | —a |] | -o } | -# | file ... 
DESCRIPTION 
Strings looks for ASCII text strings in a file. It is useful 
for examining and identifying object and other binary 
files. A string is any sequence of 4 or more printing 
characters ending with a newline or a null. If the file is 
an object file, the search is restricted to the initialized 
data space. 
Here are the options: 
—a Don’t restrict object file searches. 
-o Precede each string with its octal offset. 
—# Make # the minimum string length instead of 4. 
SEE ALSO 
od(1). 
WARNING 


The algorithm for identifying strings is rather primitive. 


NAME 


STRIP (1) 


strip — strip symbol and line number information from a 
common object file 


SYNOPSIS 


strip {—l] {-x] [-r] {[-s] [-V] filename 


DESCRIPTION 


FILES 


The strip command strips the symbol table and line 
number information from common object files, including 
archives. Once this has been done, no symbolic 
debugging access will be available for that file; therefore, 
this command is normally run only on_ production 
modules that have been debugged and tested. 


The amount of information stripped from the symbol 
table can be controlled by using any of the following 
options: 


-! Strip line number information only; do not 
strip any symbol table information. 

-x Do not strip static or external symbol 
information. 

-r Reset the relocation indexes into the symbol 
table. 

-8 Reset the line number indexes into the symbol 


table (do not remove) reset the relocation 
indexes into the symbol table. 


-V Print the version of the strip command 
executing on the standard error output. 


If there are any relocation entries in the object file and 
any symbol table information is to be stripped, strip will 
complain and terminate without stripping file-name 
unless the —r flag is used. 


If the strip command is executed on a common archive 
file (see ar(4)) the archive symbol table will be removed. 
The archive symbol table must be restored by executing 
the ar(1) command with the s option before the archive 
can be link-edited by the /d(1) command. Strip will 
instruct the user with appropriate warning messages 
when this situation arises. 


The purpose of this command is to reduce the file 
storage overhead taken by the object file. 


SEE ALSO 


ar(1), as(1), ce(L), 1d(1), a-out(4), ar(4). 


Safe 


STRIP (1) 


DIAGNOSTICS 
strip: name: cannot open 
if name cannot be read. 


strip: name: bad magic 
if name is not an appropriate common 
object file. 

strip: name: relocation entries present; cannot strip 
if name contains relocation entries and the 
-r flag is not used, the symbol table 
information cannot be stripped. 


STTY(1) 


NAME 

stty — set the options for a terminal 
SYNOPSIS 

stty | —a | { —g | [ options | 
DESCRIPTION 


Stty sets certain terminal I/O options for the device that 
is the current standard input; without arguments, it 
reports the settings of certain options, with the —a 
option, it reports all of the option settings; with the —g 
option, it reports current settings in a form that can be 
used as an argument to another sity command. Detailed 
information about the modes listed in the first five 
groups below may be found in termto(7). Options in the 
last group are implemented using options in the previous 
groups. Note that many combinations of options make 
no sense, but no sanity checking is performed. The 
options are selected from the following: 


Control Modes 


parenb (—parenb) enable (disable) parity generation 
and detection. 
parodd (—parodd) | select odd (even) parity. 


cs5 cs6 cs7 cs8 select character size (see 
termto(7)). 
0 hang up phone line immediately. 


50 75 110 134 150 200 300 600 

1200 1800 2400 4800 9600 19200 
Set terminal baud rate to the 
number given, if possible; (all 
speeds are not supported by all 
hardware interfaces); extb stands 
for 38400 or for external clock 
synchronization, depending on the 


device. 

hupcl (—hupcl) hang up (do not hang up) a 
DATA-PHONE connection on last 
close. 

hup (—hup) same as hupcl (—hupcl). 

estopb (—cstopb) use two (one) stop bits per 
character. 

cread (—cread enable (disable) the receiver. 

clocal (—clocal assume a line without (with) 


modem control. 
loblk (—loblk) block (do not block) output from 


a non-current layer. 


Input Modes 


ignbrk (—ignbrk) ignore (do not ignore) break on 
input. 


brkint (—brkint) 


ignpar (—ignpar) 


parmrk (—parmrk) 


inpck (—inpck) 
istrip (—istrip) 
inler (—inler) 
igner (—igner) 
icrnl (—icrnl) 
iucle (—iucle) 


ixon (—ixon) 


ixany (—ixany) 


ixoff (—ixoff) 


Output Modes 


opost (—opost) 
oleuc (—olcuc) 


onler (—onler) 
ocrnl (—ocrnl) 
onocr (—onocr) 
onlret (—onlret) 
ofill (—ofill) 


ofdel (—ofdel) 
crO crl er2 cr3 


STTY(1) 


signal (do not signal) INTR on 
reak. 
ignore 
errors. 
mark (do not mark) parity errors 
(see termto(7)). 


(do not ignore) parity 


enable (disable) input parity 
checking. 
strip (do not strip) input 


characters to seven bits. 

map (do not map) NL to CR on 
input. 

ignore (do not ignore) CR on 
input. 

map (do not map) CR to NL on 
input. 

map (do not map) upper-case 
alphabetics to lower case on input. 
enable (disable) START/STOP 
output control. Output is stopped 
by sending an ASCII DC3 and 
started by sending an ASCII DC1. 
allow any character (only DC1) to 
restart output. 

request that the system send (not 
send) START/STOP characters 
when the input queue is nearly 
empty /full. 


post-process output (do not post- 
process output; ignore all other 
output modes). 


map (do not map) lower-case 
alphabetics to upper case on 
output. 


map (do not map) NL to CR-NL 
on output. 

map (do not map) CR to NL on 
output. 

do not (do) output CRs at column 
zero. 

on the terminal NL performs (does 
not perform) the CR function. 

use fill characters (use timing) for 
delays. 

fill characters are DELs (NULs). 
select style of delay for carriage 
returns (see termto(7)). 


TELNET (1N) 


options Turn on/off viewing of TELNET 
options negotiations. Initially viewing 
is off. When viewing is on, telnet 
shows its negotiations with the ftelnetd. 


quit Close any open connection and 
terminate telnet. 

status Show the current connection and escape 
character. 

will option Tell the remote server we will process 


option. This command is used mostly 
for testing option negotiation. 


wont option Tell the remote server we won’t process 
option. This command is used mostly 
for testing option negotiation. 


escape character Send the escape character to the 
remote host. 


Input Mode 


Telnet enters input mode when a connection is opened 
and leaves it when a connection is closed. In input mode 
all text typed goes to the remote node except when the 
escape character is typed. 


To enter a single telnet command without first closing 
the connection, press the escape character at any time in 
input mode. Initially the escape character is control-| 
ASCIL GS; octal 035); Telnet gives its prompt 
te toinet ss and executes a single command line instead 
of sending it to the remote node. After you press the 
RETURN key and the command is executed, telnet 
resumes sending your input to the remote node, unless 
your command closed the connection (close or quit). 


Use the escape command to change the escape 
character. 


Telnet Options 


5/86 


Once a connection is established, both sides negotiate 
various options to get the best possible service. The 
following options are recognized: 


BINARY Controls transmission of binary data. 
ECHO Controls echoing. 
SGA Suppress go ahead. 
STATUS Status of options. 
T™T™ Timing Mark. 
EXOPL Extended Options List. 
miSee 


TELNET (1N) 


SEE ALSO 
rlogin(1N), telnetd(1NM). 


5/86 AS 


TELNETD (1NM ) 


NAME 

telnetd - DARPA TELNET protocol server 
SYNOPSIS 

/etc/telnetd | —d | [ port | 
DESCRIPTION 


Telnetd is a server that supports the DARPA standard 
TELNET virtual terminal protocol. The TELNET 
server operates at the port indicated in the ‘“‘telnet”’ 
service description; see services(4N). This port number 
may be overridden (for debugging purposes) by 
specifying a port number on the command line. If the 
—d option is specified, each socket created by telnetd will 
have debugging enabled (see SO_DEBUG in socket(2N)). 


Telnetd operates by allocating a virtual-terminal device 
(see vt(7)) for a client, then creating a login process 
which has the slave side of the pseudoterminal as stdin, 
stdout, and stderr. Telnetd manipulates the master side 
of the pseudoterminal, implementing the TELNET 
protocol and passing characters between the client and 
login process. 


When a TELNET session is started up, telnetd sends a 
TELNET option to the client side indicating a 
willingness to do “remote echo” of characters. The 
pseudoterminal allocated to the client is configured to 

operate in “cooked” mode and with XTABS and | 
CRMOD enabled (see éty(7)). Aside from this initial 
setup, the only mode changes telnetd will carry out are 
those required for echoing characters at the client side of 

the connection. 


The following options are recognized: 


BINARY Controls transmission of binary data. 
ECHO Controls echoing. 
SGA Suppress go ahead. 
STATUS Status of options. 
TM Timing Mark. 
EXOPL Extended Options List. 
SEE ALSO 
telnet(1N). 


5/86 Lie 


NAME 


TEST (1) 


test — condition evaluation command 


SYNOPSIS 
test expr 
[ expr 


DESCRIPTION 


Test evaluates the expression expr and, if its value is 
true, returns a zero (true) exit status; otherwise, a non- 
zero (false) exit status is returned; test also returns a 
non-zero exit status if there are no arguments. The 
following primitives are used to construct ezpr: 


—r file 
—w file 
—x file 
-f file 
—d file 
—c file 


—b file 
—p file 
—u file 
—g file 
—k file 
—s file 


—t | fildes | 


—z 61 
—n si 


si = 82 
sl != 82 
$1 

ni -—eq n2 


true if file exists and is readable. 
true if file exists and is writable. 
true if file exists and is executable. 
true if file exists and is a regular file. 
true if file exists and is a directory. 


true if file exists and is a character special 
file. 


true if file exists and is a block special file. 
true if file exists and is a named pipe (fifo). 


true if file exists and its set-user-ID bit is 
set. 


true if file exists and its set-group-ID bit is 
set. 


true if file exists and its sticky bit is set. 


true if file exists and has a size greater 
than zero. 


true if the open file whose file descriptor 
number is fildes (1 by default) is associated 
with a terminal device. 


true if the length of string si is zero. 


true if the length of the string si is non- 
zero, 


true if strings s1 and 82 are identical. 
true if strings sf and s2 are not identical. 
true if s1 is not the null string. 


true if the integers ni and n2 are 
algebraically equal. Any of the 
comparisons —ne, ~gt, —ge, —It, and —le 
may be used in place of —eq. 


2 phe 


TEST (1) 


These primaries may be combined with the following 


operators: 

! unary negation operator. 

—a binary and operator. 

—o binary or operator (—a_ has _ higher 
precedence than —o). 

( expr ) parentheses for grouping. 


Notice that all the operators and flags are separate 
arguments to test. Notice also that parentheses are 
meaningful to the shell and, therefore, must be escaped. 


SEE ALSO 
expr(1), find(1), sh(1). 

WARNING 
In the second form of the command (i.e., the one that 
uses [], rather than the word fest), the square brackets 
must be delimited by blanks. 


Some UNIX systems do not recognize the second form of 
the command. 


NAME 


TFTP(1N) 


tftp — user interface to the DARPA TF TP protocol 


SYNOPSIS 


tftp [ host [ port | | 


DESCRIPTION 


FILES 


Tftp is the user interface to the ARPANET standard 
Trivial File Transfer Protocol. The program allows a 
user to transfer files to and from a remote network site. 


The client host with which tftp is to communicate may 
be specified on the command line. If this is done, tftp 
will immediately attempt to establish a connection to a 
TFTP server on that host. Otherwise, tftp will enter its 
command interpreter and await instructions from the 
user. When tftp is awaiting commands from the user, 
the prompt 


tftp > 
appears. The following commands are recognized by 
tftp: 
connect 

connect to remote tftp 


mode set file to transfer mode 


put send file 


get receive file 
quit = exit tftp 
verbose 


toggle verbose mode 
trace toggle packet tracing 
status show current status 
rexmt set total retransmission 
? print help information 


timeout 

set total retransmission timeout 
The use of tftp does not require an account or password 
on the remote system. Due to the lack of authentication 
information, tftp will allow only publicly readable files to 
be accessed. 


/etc/hosts 


SEE ALSO 


tftpd(1NM). 


TFTP(1N) 


WARNINGS 
Due to the unreliability of the transport protocol (UDP) 
and the scarcity of TFTP implementations, it is 
uncertain whether it really works. 


The search permissions of the directories leading to the 
files accessed are not checked. 


NAME 


TFTPD(1NM) 


tftpd ~ DARPA Trivial File Transfer Protocol server 


SYNOPSIS 


/ete/tftpd [| —d ] [ port | 


DESCRIPTION 


Tftpd is a server which supports the DARPA Trivial File 
Transfer Protocol. The TFTP server operates at the 
port indicated in the ‘‘tftp” service description; see 
services(4). This port number may be overridden (for 
debugging purposes) by specifying a port number on the 
command line. If the —d option is specified, each socket 
created by tftpd will have debugging enabled (see 
SO_DEBUG in socket(2N)). 


The use of tftp does not require an account or password 
on the remote system. Due to the lack of authentication 
information, tftpd will allow only publicly readable files 
to be accessed. Note that this extends the concept of 
‘“‘public”? to include all users on all hosts that can be 
reached through the network; this may not be 
appropriate on all systems, and its implications should be 
considered before enabling tftp service. 


SEE ALSO 


BUGS 


tftp(1N), netman(1N). 


This server is known only to be self consistent (i.e. 
operates with the user TF TP program, tftp UDP) ue . 
the unreliability of the transport protocol (UD and the 
scarcity of TFTP implementations, it is ean 
whether it really works. 


The search permissions of the directories leading to the 
files accessed are not checked. 


= 


TIC(1M) 


NAME 

tic — terminfo compiler 
SYNOPSIS 

tic { —v(nj | file ... 
DESCRIPTION 


Tic translates terminfo files from the source format into 
the compiled format. The results are placed in the 
directory /usr/lib/terminfo. 


The -—v (verbose) option causes tic to output trace 
information showing its progress. If the optional integer 
is appended, the level of verbosity can be increased. 


Tic compiles all terminfo descriptions in the given files. 
When a use= field is discovered, tic searches first the 
current file, then the master file, which is 
“* /terminfo.sre’’. 


If the environment variable TERMINFO is set, the 
results are placed there instead of /usr/lib/terminfo. 
Some limitations: total compiled entries cannot exceed 
4096 bytes. The name field cannot exceed 128 bytes. 
FILES 
/usr/lib/terminfo/*/* compiled terminal capability 
data base 
SEE ALSO 
curses(3X), terminfo(4). 
BUGS 
Instead of searching ./terminfo.src, it should check for 
an existing compiled entry. 


TIME(1) 


NAME 
time — time a command 

SYNOPSIS 
time command 

DESCRIPTION 
The command is executed; after it is complete, ttme 
prints the elapsed time during the command, the time 
spent in the system, and the time spent in execution of 
the command. Times are reported in seconds. 
The times are printed on standard error. 


SEE ALSO 
timex(1), times(2). 


TIMEX(1) 


NAME 
timex -— time a command; report process data and 
system activity 


SYNOPSIS 
timex | options ] command 


DESCRIPTION 
The given command is executed; the elapsed time, user 
time and system time spent in execution are reported in 
seconds. Optionally, process accounting data for the 
command and all its children can be listed or - 
summarized, and total system activity during the 
execution interval can be reported. 


The output of timez is written on standard error. 
Options are: 


-p___ List process accounting records for command and 
all its children. Suboptions f, h, k, m, r, and t 
modify the data items reported, as defined in 
acctcom(1). The number of blocks read or written 
and the number of characters transferred are 
always reported. 


—o Report the total number of blocks read or written 
and total characters transferred by command and 
all its children. 
| 
| 


~s Report total system activity (not just that due to 
command) that occurred during the execution 
interval of command. All the data items listed in 
sar(1) are reported. 


SEE ALSO 
acctcom(1), sar(1). 


WARNING 
Process records associated with command are selected 
from the accounting file /usr/adm/pacct by inference, 
since process genealogy is not available. Background 
processes having the same user-id, terminal-id, and 
execution time window will be spuriously included. 


EXAMPLES 
A simple example: 


TIMEX(1) 


timex —ops sleep 60 


A terminal session of arbitrary complexity can be 
measured by timing a sub-shell: 


timex —opskmt sh 
session commands 
EOT 


NAME 


TOC(1G) 


toc — graphical table of contents routines 


SYNOPSIS 


dtoe [directory] 
ttoc mm-file 
vtoe [(-edhnimsvn] [TTOC file] 


DESCRIPTION 
All 


the commands listed below’ reside’ in 


/usr/bin/graf (see graphics(1G)). 


dtoc 


ttoc 


vtoc 


Dtoc makes a textual table of contents, 
TTOC, of all subdirectories beginning at 
directory (directory defaults to .). The list 
has one entry per directory. The entry fields 
from left to right are level number, directory 
name, and the number of ordinary readable 
files in the directory. Dtoc is useful in 
making a visual display of all or parts of a 
file system. The following will make a visual 
display of all the readable directories under 


dtoc / | vtoc | td 


Output is the table of contents generated by 
the .TC macro of mm(1) translated to TTOC 
format. The input is assumed to be an mm 
file that uses the .H family of macros for 
section headers. If no file is given, the 
standard input is assumed. 


Vtoe produces a GPS describing a hierarchy 
chart from a TTOC. The output drawing 
consists of boxes containing text connected in 
a tree structure. If no file is given, the 
standard input is assumed. Each TTOC entry 
describes one box and has the form: 


td (line-wetght,line-style| "text" (mark| 


where: 


td is an alternating sequence of 
numbers and dots. The td 
specifies the position of the 
entry in the hierarchy. The td 
Q. is the root of the tree. 
line-wetght — is either: 
n, normal-weight; or 
m, medium-weight; or 
b, bold-weight. 


ts 


TOC(1iG) 


line-atyle is either: 
so, solid-line; 
do, dotted-line; 
dd, = dot-dash 
line; 
da, dashed-line; 
or 
ld, long-dashed 
text is a character string surrounded 


mark 


by quotes. The characters 
between the quotes become the 
contents of the box. To include 
a quote within a box it must be 
escaped (\"). 


is a character string 
(surrounded by quotes if it 
contains spaces), with included 
dots being escaped. The string 
is put above the top right 
corner of the box. To include 
either a quote or a dot within a 
mark it must be escaped. 


Entry example: 1.1 b,da “ABC” DEF 
Entries may span more than one line by 
escaping the new-line (\new-line). 


Comments are surrounded by the /*,*/ pair. 


They 


may appear anywhere in a TTOC. 


Options: 


¢c 


d 
hn 


SEE ALSO 


Use text as entered (default is all upper 
case). 


Connect the boxes with diagonal lines. 


Horizontal interbox space is n% of box 
width. 


Suppress the box #d. 
Suppress the box mark. 
Do not compact boxes horizontally. 


Vertical interbox space is n% of box 
height. 


graphics(1G), gps(4). 


TOUCH (1) 


NAME 
touch — update access and modification times of a file 


SYNOPSIS 
touch | —ame | [ mmddhhmml|yy] ] files 


DESCRIPTION 

Touch causes the access and modification times of each 
argument to be updated. The file name is created if it 
does not exist. If no time is specified (see date(1)) the 
current time is used. The —a and —m options cause 
touch to update only the access or modification times 
respectively (default is -am). The ~e option silently 
prevents fouch from creating the file if it did not 
previously exist. 

The return code from touch is the number of files for 
which the times could not be successfully modified 
(including files that did not exist and were not created). 


SEE ALSO 
date(1), utime(2). 


TPLOT (1G) 


NAME 

tplot — graphics filters 
SYNOPSIS 

tplot [| —Tterminal [ —e raster ] ] 
DESCRIPTION 


These commands read plotting instructions (see plot(4)) 
from the standard input and in general produce, on the 
standard output, plotting instructions suitable for a 
particular terminal. If no terminal is specified, the 
environment parameter $TERM (see environ(5)) is used. 
Known terminals are: 


300 DASI 300. 

3300S. DASI 300s. 

450 DASI 450. 

4014 TEKTRONIX 4014. 

ver Versatec D1200A. This version of plot places a 
scan-converted image in /usr/tmp/raster$$ 
and sends the result directly to the plotter 
device, rather than to the standard output. The 
—e option causes a previously scan-converted file 
raster to be sent to the plotter. 


FILES 
/usr/lib/t300 
/usr/lib/t300s 
/usr/lib/t450 
/usr/lib/t4014 
/usr/lib/vplot 
/usr/tmp/raster$$ 

SEE ALSO 
plot(3X), plot(4), term(5). 


NAME 


TPUT (1) 


tput — query terminfo database 


SYNOPSIS 


tput | —Ttype ] capname 


DESCRIPTION 


Tput uses the terminfo(4) database to make terminal- 
dependent capabilities and information available to the 
shell. Tput outputs a string if the attribute (capability 
name) is of type string, or an integer if the attribute is 
of type integer. If the attribute is of type boolean, tput 
simply sets the exit code (0 for TRUE, 1 for FALSE) 
and does no output. 


, 


—T type indicates the type of terminal. Normally 
this flag is unnecessary, as the default is 
taken from the environment’ variable 
$TERM. 

Capname indicates the attribute from the terminfo 
database. See terminfo(4). 


EXAMPLES 


FILES 


tput clear Echo clear-screen sequence for the 
current terminal. 

tput cols Print the number of columns for the 
current terminal. 

tput —T450 cols Print the number of columns for the 
450 terminal. 

bold='‘tput smso‘ 
Set shell variable “bold” to stand- 
out mode sequence for current 
terminal. This might be followed by 
a prompt: 
echo "${bold}Please type in 
your name: \c” 

tput he Set exit code to indicate if current 
terminal is a hardcopy terminal. 


/ete/term/?/* Terminal descriptor files 
/usr/include/term.h Definition files 
/usr/include/curses.h 


DIAGNOSTICS 


Tput prints error messages and returns the following 
error codes on error: 


-1 Usage error. 
-2 Bad terminal type. 
—3 Bad capname. 


TPUT(1) 


In addition, if a capname is requested for a terminal that 
has no value for that capname (e.g., tput —T450 lines), 
—1 is printed. 

SEE ALSO 
stty(1), terminfo(4). 


NAME 


TR(1) 


tr — translate characters 


SYNOPSIS 


tr { —cds | [ stringl [( string2 | | 


DESCRIP TION 


Tr copies the standard input to the standard output 
with substitution or deletion of selected characters. 
Input characters found in string! are mapped into the 
corresponding characters of string?. Any combination of 
the options —cds may be used: 


—¢ Complements the set of characters in string 
with respect to the universe of characters whose 
ASCII codes are 001 through 377 octal. 


—d Deletes all input characters in string!. 

-s Squeezes all strings of repeated output 
characters that are in string2 to single 
characters. 


The following abbreviation conventions may be used to 
introduce ranges of characters or repeated characters 
into the strings: 


[a—z] Stands for the string of characters whose ASCII 
codes run from character a to character g, 
inclusive. 


[a*n] Stands for n repetitions of a. If the first digit 
of n is O, n is considered octal; otherwise, n is 
taken to be decimal. A zero or missing n is 
taken to be huge; this facility is useful for 
padding string2. 

The escape character \ may be used as in the shell to 

remove special meaning from any character in a string. 

In addition, \ followed by 1, 2, or 3 octal digits stands 

for the character whose ASCII code is given by those 

digits. 

The following example creates a list of all the words in 

filed one per line in file2, where a word is taken to be a 

maximal string of alphabetics. The strings are quoted to 

protect the special characters from interpretation by the 
shell; 012 is the ASCII code for newline. 


tr -cs "{[A-Z][a—z]" ”{\012*]" <filel >file2 


SEE ALSO 


ed(1), sh(1), ascii(5). 


TR(i) 


BUGS 
Will not handle ASCII NUL in string1 or string2; always 


deletes NUL from input. 


NAME 


TROFF (1) 


troff ~ typeset text 


SYNOPSIS 


troff [| options | [ files | 


DESCRIPTION 


5/86 


Troff formats text. contained in files {standard input by 
default) for a Wang Laboratories, Inc., C/A/T 
phototypesetter. Its capabilities are described in the 
NROFF / TROFF User’s Manual cited below. 


If no input file is given, or if the argument — is found, 
troff reads from the standard input file. The options, 
which may appear in any order, but must appear before 
the files, are: 


—olist Print only pages whose page numbers appear 
in the fist of numbers and ranges, separated 
by commas. A range N—M means pages N 
through M; an initial ~N means from the 
beginning to page N; and a final N— means 
from N to the end. (See BUGS below.) 

—-nN Number first generated page N. 

-—sN Stop every N pages. Troff will stop the 
phototypesetter every N pages, produce a 
trailer to allow changing cassettes, and resume 
when the typesetter’s start button is pressed. 


—raN Set register @ (which must have a one- 
character name) to N. 

-i Read standard input after files are exhausted. 

~q Invoke the simultaneous input-output mode of 
the .rd request. 

—z Print only messages generated by .tm 


(terminal message) requests. 
—mname Prepend to the input files the non-compacted 
(ASCII text) macro file 
fase AP) nee ae name. 
repend to the input files the compacted 
macro files 
/usr /lib/macros/emp.(nt] rename and 


—cname 


/usr/lib/macros/ucmp.|nt|.name. 

—kname Compact the macros used in this invocation of 
troff, placing the output in files [dt].name in 
the current directory (see the May 1979 
Addendum to the NROFF/TROFF User’s 
Manual for details of compacting macro files). 


-t Direct output to the standard output instead 
of the phototypesetter. 
—f Refrain from feeding out paper and stopping 


phototypesetter at the end of the run. 


“4s 
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—w Wait until phototypesetter is available, if it is 
currently busy. 

—b Report whether the phototypesetter is busy or 
available. No text processing is done. 

~a Send a printable ASCII] approximation of the 
results to the standard output. 

—pN Print all characters in point size N while 


retaining all prescribed spacings and motions, 
to reduce phototypesetter elapsed time. 

-g Prepare output for the Murray Hill 
Computation Center phototypesetter and 
direct it to the standard output (this option is 
not usable on most systems). This option is 
not compatible with the  —s_ option; 
furthermore, when this option is invoked, all 
fp (font position) requests (if any) in the troff 
input must come before the first break, and 
no .tl requests may come before the first 


break. 
—Tname Use font-width tables for device name (the 
font tables are found in 


/usr/lib/font/name/*). | Currently, — no 
names are supported. 


FILES 
/usr/lib/suftab suffix hyphenation tables 
/tmp/ta$# temporary file 
/usr/lib/tmac/tmac.* standard macro files and pointers 
/usr/lib/macros/* standard macro files 
/usr/lib/font/* font width tables for troff 

SEE ALSO 


BUGS 


NROFF / TROFF User’s Manual and A TROFF Tutorial 
in the UNIX System Document Processing Guide. 

ew(1), eqn(1), mmt(1), nroff(1), tbl(1), tc(1), mm(5), 
mv(5). 


Troff believes in Eastern Standard Time; as a result, 
depending on the time of the year and on your local time 
zone, the date that troff generates may be off by one 
day from your idea of what the date is. 

When troff is used with the —olist option inside a 
pipeline (e.g., with one or more of cw(1), eqn(1), and 
tbl(1)), it may cause a harmless “broken pipe”’ diagnostic 
if the last page of the document is not specified in list. 


TRPT(1NM) 


NAME 
trpt — print protocol trace 

SYNOPSIS 
trpt {| -a} [-s] [| -t] [ -j ] | —p hex-address | 
{ system [ core | ] 

DESCRIPTION 


Trpt interrogates the buffer of TCP trace records created 
when a _ socket is marked for debugging (see 
setsockopt(2N)), and prints a readable description of 
these records. When no options are supplied, trpt prints 
all the trace records found in the system grouped 
according to TCP connection protocol control block 
(PCB). The following options may be used to alter this 


behavior. 

-8 in addition to the normal output, print a 
detailed description of the packet sequencing 
information, 

—t in addition to the normal output, print the 
values for all timers at each point in the trace, 

-j just give a list of the protocol control block 
addresses for which there are trace records, 

-—p show only trace records associated with the 


protocol control block who’s address follows, 


-a in addition to the normal output, print the 
values of the source and destination addresses 
for each packet recorded. 


The recommended use of trpt is as follows. Isolate the 
problem and enable debugging on the socket(s) involved 
in the connection. Find the address of the protocol 
control biocks associated with the sockets using the —A 
option to netstat(1N). Then run trpt with the —p 
option, supplying the associated protocol control block 
addresses. If there are many sockets using the debugging 
option, the —j option may be useful in checking to see if 
any trace records are present for the socket in question. 


If debugging is being performed on a system or core file 
other than the default, the last two arguments may be 
used to supplant the defaults. 
CONFIGURATION 

To use trpt, your kernel must be configured for network 
debugging. See config(IM) and master(4). The 
tceptrace parameter must be non-zero for tracing to 
occur. 
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FILES 
/unix 
/dev/kmem 


SEE ALSO 
setsockopt(2N), netstat(1N) 

DIAGNOSTICS / ; 
‘no namelist”? when the system image doesn’t contain 
the proper symbols to find the trace buffer; others which 
should be self explanatory. 

WARNINGS 
Trace will be incomplete for connections using intelligent 
network controllers. 


TRUE(1) 


NAME 
true, false — provide truth values 


SYNOPSIS 
true 


false 


DESCRIPTION 
True does nothing, successfully. False does nothing, 
unsuccessfully. They are typically used in input to sh(1) 


such as: 
while true 
do 
command 
done 
SEE ALSO 
sh(1). 
DIAGNOSTICS 


True has exit status zero, false nonzero. 


TSET(1) 


NAME 
tset — set terminal, terminal inteface, and terminal 
environment 

SYNOPSIS 
tset [ options | [ —m [pseudotype||test speed|:type ... | 
[ type | 

DESCRIPTION 


Tset initializes your terminal. Its primary use is in login 
scripts (see profile(4)) to set terminal options, terminal 
interface options, and environment variables. Its 
secondary use is to restore the terminal interface and 
terminal after an editor or other video program has 
crashed. 


To restore th al interface and term 


e inal interface and terminal, just ty 
“tset”’. It may be necessary to end the command vith 
Control-J or the NEXT key instead of the RETURN key. 


To set up login initialization, construct a command with 
the options and arguments you need and place it in your 
login script. 

An argument indicates a terminal type to use in place of 
the TERM environment variable. If the argument 
begins with a question mark, tset prompts you for a 
terminal type; if you enter a blank line, you get the type 
specified by the argument. Terminal type arguments (i 
conjunction with the — or —s options) are useful a 
installations where none of the terminals are 
permanently connected to the host. 


termina 
vermina 


z< ¢ 


Tset accepts the following options. 


- Print the terminal type. This is useful for 
setting the TERM environment variable in the 
profile file: 


export TERM 
TERM= ‘tset — ’?adm3a7’* 


-s Print commands that will set the TERM and 
TERMCAP environment variables. The value 
for TERMCAP contains a description of the 
terminal; this makes it unnecessary for programs 
to read the terminal capability file each time 
they start up. For example: 


eval ‘tset —s ’?adm3a ’* 


Tset uses the SHELL environment variable to 
decide the kind of commands to print. 


—ec 
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Prints values for TERM and TERMCAP 
Useful only in .login; if you use the values to set 
a shell variable, you get a two-element array. 


Set the erase character to c. Indicate a control 
character with a *. If c is missing, tset uses the 
value of your backspace key; this is usually 
contro-H. You also get control-H if your 
terminal lacks a backspace key. 

Set the kill character to c. Indicate a control 
character with a ~*~. If ¢ is missing tset uses 
control-X. 


Don’t initialize the terminal. 
Don’t remind user of erase and kill values. 


—mypscudotype test speedstype 


FILES 


Use one or more —m options in place of a type 
argument when you want ¢set to figure out your 
terminal type for you. Pseudotype should be a 
type that your installation has reserved for a 
class of “soft”? connections, such as dialup, 
arpanet, or plugboard. A missing pseudotype 
means ‘‘any type.’’. Test and speed indicate a 
class of baud rates. Test is == or @ for 
“equals”; < for “less than”; > for “greater 
than”; or [=, !@, !<, or !> for negations. A 
missing speed indication means “‘all speeds.” 
Type is the type to assume if the pseudotype and 
terminal speeds match. Type can begin with a 
question mark to indicate a user query. Thus, 


tset - -m ’dialup@300:trs80’ —m /dialup:tO ” 


prints “‘trs80” if TERM is “dialup” and the 
baud rate is 300; ‘‘t0” if TERM is ‘“‘dialup” and 
the baud rate isn’t 300; and the value of TERM 
otherwise. 


/etc/ttytype | type wired to each port 
/etc/termcap terminal capability database 


SEE ALSO 
sh(1), 


stty(1), profile(4),  ttytype(4),  termcap(4), 


environ(5). 


DIAGNOSTICS 


Nonzero return status if it could not process all options 
and user input. This is useful to confirm that user 
entered known terminal type: see profile(4) for an 
example. 


TSORT(1) 


NAME 

tsort — topological sort 
SYNOPSIS 

tsort [ file | 
DESCRIPTION 


Tsort produces on the standard output a totally ordered 
list of items consistent with a partial ordering of items 
mentioned in the input file. If no file is specified, the 
standard input is understood. 


The input consists of pairs of items (nonempty strings) 
separated by blanks. Pairs of different items indicate 
ordering. Pairs of identical items indicate presence, but 
not ordering. 


lorder(1). 


DIAGNOSTICS 
Odd data: there is an odd number of fields in the input 
file. 


BUGS 
Uses a quadratic algorithm; not worth fixing for the 
typical use of ordering a library archive file. 


TTY(1) 


NAMIE 
tty — get the name of the terminal 

SYNOPSIS 
tty [| -s | 

DESCRIPTION 
Tty prints the path name of the user’s terminal. The —s 
option inhibits printing of the terminal path name, 
allowing one to test just the exit code. 

EXIT CODES 
2 if invalid options were specified, - 
0 if standard input is a terminal, 
1 otherwise. 

DIAGNOSTICS 


“not a tty” if the standard input is not a terminal and 
~s is not specified. 


UL(1) 


NAME 

ul — do underlining 
SYNOPSIS 

ul { -i |] [ -t terminal | [ name ... | 
DESCRIPTION 


Ul reads the named files (or standard input if none are 
given) and translates occurrences of underscores to the 
appropriate underlining sequence for the terminal in use, 
as specified by the environment variable TERM. The -t 
option overrides the terminal type specified in the 
environment. The /etc/termcap file is read to 
determine the appropriate sequences for underlining. If 
the terminal is incapable of underlining but is capable of 
a standout mode, standout mode is used instead. If the 
terminal can overstrike or handles underlining 
automatically, ul reverts to cat(1). If the terminal 
cannot underline, underlining is ignored. 


The —i option causes ul to indicate underlining by a 
string of hyphens on the following line. This is useful for 
looking at the underlining in an nroff output stream on a 
terminal. 


SEE ALSO 


man(1), nroff(1). 


AUTHOR 


BUGS 
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Mark Horton. 


Nroff usually outputs a series of backspaces and 
underlines intermixed with the text to indicate 
underlining. No attempt is made to optimize the 
backward motion. 


NAME 


UMASK(1) 


umask — set file-creation mode mask 


SYNOPSIS 


umask [ 000 | 


DESCRIPTION 


SEE AL 


The user file-creation mode mask is set to 000. The 
three octal digits refer to read/write/execute permissions 
for owner, group, and others, respectively (see chmod(2) 
and veest(2)): The value of each specified digit is 
subtracted from the corresponding “digit” specified by 
the system for the creation of a file (see creat(2)). For 
example, umask 022 removes group and others write 
permission (files normally created with mode 777 
become mode 7565; files created with mode 686 become 
mode 644). 


If ooo is omitted, the current value of the mask is 
printed. 


Umask is recognized and executed by the shell. 


sO 
chmod(1), sh(1), chmod(2), creat(2), umask(2). 


NAME 

uname — print name of current CTIX system 
SYNOPSIS 

uname [{ —snrvma | 
DESCRIPTION 


Uname prints the name of the CTIX system on the 
standard output file. It is mainly useful to determine 
which system one is using. The options cause selected 
information returned by uname(2) to be printed: 


-s print the system name (default). 


—n print the nodename (the nodename may be a 
name that the system is known by to a 
communications network). 


-? print the operating system release. 
-v print the operating system version. 
—-m print the machine hardware name. 
—a print all the above information. 
Arguments not recognized default the command to the 
—8 option. 
SEE ALSO 
uname(2). 


NAME 


UNGET (1) 


unget — undo a previous get of an SCCS file 


SYNOPSIS 


unget {—rSID] [—s] {—n] files 


DESCRIPTION 


Unget undoes the effect of a get ~—e done prior to 
creating the intended new delta. If a directory is named, 
unget behaves as though each file in the directory were 
specified as a named file, except that non-SCCS files and 
unreadable files are silently ignored. If a name of — is 
given, the standard input is read with each line being 
taken as the name of an SCCS file to be processed. 


Keyletter arguments apply independently to each named 
file. 


—rsiID Uniquely identifies which delta is no 
longer intended. (This would have 
been specified by get as the ‘new 
delta”). The use of this keyletter is 
necessary only if two or more 
outstanding gets for editing on the 
same SCCS file were done by the 
same person (login name). A 
diagnostic results if the specified SID 
is ambiguous, or if it is necessary and 
omitted on the command line. 


—8 Suppresses the printout, on the 
standard output, of the intended 
delta’s SID. 


—n Causes the retention of the gotten file 
which would normally be removed 
from the current directory. 


SEE ALSO 


delta(1), get(1), help(1), sact(1). 


DIAGNOSTICS 


Use help(1) for explanations. 


UNIQ(1) 


NAME 
uniq ~ report repeated lines in a file 


SYNOPSIS 
uniq [| —ude { +n ] [ —n ] | [ input [ output | | 

DESCRIPTION 
Uniq reads the input file comparing adjacent lines. In 
the normal case, the second and succeeding copies of 
repeated lines are removed; the remainder is written on 
the output file. Input and output should always be 
different. Note that repeated lines must be adjacent in 
order to be found; see sort(1). If the —u flag is used, 
just the lines that are not repeated in the original file are 
output. The —d option specifies that one copy of just 
the repeated lines is to be written. The normal mode 
output is the union of the —u and —d mode outputs. 


The —c option supersedes —u and ~d and generates an 
output report in default style but with each line 
preceded by a count of the number of times it occurred. 


The n arguments specify skipping an initial portion of 
each line in the comparison: 


—n The first n fields together with any blanks 
before each are ignored. A field is defined as a 
string of non-space, non-tab characters 
separated by tabs and spaces from _ its 
neighbors. 


+n The first n characters are ignored. Fields are 
skipped before characters. 


SEE ALSO 
comm(lL), sort(1). 


UNITS(1) 


NAME 
units — conversion program 
SYNOPSIS 
units 
DESCRIPTION 
Units converts quantities expressed in various standard 
scales to their equivalents in other scales. It works 
interactively in this fashion: 
You have: inch 
You want: em 
* 2.540000e+00 
/ 3.937008e-01 
A quantity is specified as a multiplicative combination of 
units optionally preceded by a numeric multiplier. 
Powers are indicated by suffixed positive integers, 
division by the usual sign: 
You have: 15 lbs force/in2 
You want: atm 
* 1.020689e+00 
/ 9.797299e-01 
Units only does multiplicative scale changes; thus it can 
convert Kelvin to Rankine, but not Celsius to 
Fahrenheit. Most familiar units, abbreviations, and 
metric prefixes are recognized, together with a generous 
leavening of exotica and a few constants of nature 
including: 
pi ratio of circumference to diameter, 
c speed of light, 
e charge on an electron, 
g acceleration of gravity, 
force same as g, 
mole Avogadro’s number, 
water pressure head per unit height of water, 
au astronomical unit. 
Pound is not recognized as a unit of mass; lb is. 
Compound names are run together, (e.g., lightyear). 
British units that differ from their U.S. counterparts are 
prefixed thus: brgallon. For a complete list of units, 
type: 
cat /usr/lib/unittab 
FILES 


/usr/lib/unittab 


UPDATE(1M) 


NAME 

update — provide disk synchronization 
SYNOPSIS 

update | 3 | 
DESCRIPTION 


Update implements regular synchronization. Run it only 

once, in background; normally there is an update 

command in /ete/re. 

Update executes an infinite loop with two actions: 

° A sleep for 8 seconds (30 seconds default). 

e A syne system call. This feature calls for less 
overhead than the practice of having the cron 
command run sync. 


FILES 
/dev/dsk/* — disk interfaces 


SEE ALSO 
ioctl(2), sleep(3), fp(7). 


UUCHECK (1M) 


NAME 
uucheck — check the UUCP directories and Permissions 
file 

SYNOPSIS 
/usr/lib/uuep/uucheck | —v } [| —x debug_level | 


DESCRIPTION 

Uucheck checks for the presence of the UUCP system 
required files and directories. Within the uucp makefile, 
uucheck is executed before the installation takes place. 
It also checks for some obvious errors in the Permissions 
file (/usr/lib/uucp/Permissions). When executed 
with the —v option, it gives a detailed explanation of 
how the UUCP programs will interpret the Permissions 
file. The —x option is used for debugging; it takes a 
single digit, where higher numbers provide more detail. 


FILES 
/usr/lib/uuep/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/lib/uucp/Maxuuxqts 
/usr/spool/uucp/* 
/usr/spool/uucp/LCK* 
/usr/spool/uucppublic/* 
SEE ALSO 
uucico(1M), uucp(1C), wusched(1M), — uustat({1C), 
uux(1C). 
BUGS 
The program does not check file/directory modes or 
some errors in the Permissions file, such as duplicate 
login or machine name. 
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UUCICO( 1M) 


NAME 
uucico — copy-in/copy-out program for the UUCP 
system 
SYNOPSIS 
usr/lib/uucp/uucico | —r role_number | 
-x debug_level | { -d_ spool_directory | —s 
system_name 
DESCRIPTION 


Uucico is the UUCP demon that sends and receives data 
in the UUCP system. Uucico is normally invoked by the 
scheduler, uusched, but it can be invoked manually for 
debugging. Other commands, such as wuz(1C) and 
uucp(1C), also invoke uucico. For example, Uutry(1M) 
starts wuctco with debugging turned on. 

FILES 
/usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/lib/uucp/Maxuuxqts 
/usr/spool/uucp/* 
/usr /spool /locks/LCK.* 
/usr/spool/uucppublic/* 

SEE ALSO 
uucp(1C), uusched(1M), uustat(1C), Uutry(1M), uux(1C). 
MightyFrame Administrator’s Reference Manual. 
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NAME 


UUCLEANUP (1M) 


uucleanup — uucp spool directory clean-up 


SYNOPSIS 


/usr/lib/uucp/uucleanup [ options | 


DESCRIPTION 
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Uucleanup scans the spool directories for old files and 
takes appropriate action to remove them in a useful way: 
inform the requester of send/receive requests for systems 
that cannot be reached; return undeliverable mail to the 
sender; delete or execute rnews for remote news files; 
remove all other files. In addition, provision is made to 
warn users of requests that have been waiting for a given 
number of days (default 1 day). 


The following options are available. If the option is not 


specified on the command line, the default value is used. 
—Ctime Remove any C. files greater than or 


equal to time days old and _ send 
appropriate information to the 
requester. (Default 7 days) 


—Dtime Remove any D. files greater or equal to 
time days old. Attempt to deliver mail 
Messages and execute rnews when 
appropriate. Note: rnews is public 
domain software not provided with 
CTIX. (Default 7 days) 


—Wtime For C. files equal to time days old send 
to the requester a warning about the 
delay in contacting the remote location. 
The message includes the JOBID and, 
in the case of mail, the mail message. 
The administrator may include a 
message line telling who to call about 
the problem (see the -—m_ option). 
(Default 1 day) 


—Xtime Remove any X. files greater than or 
equal to time days old. The D. files are 
probably not present (otherwise, the X. 
files would be executed). If there are D. 
files, they will be taken care of by D. 
processing. (Default 2 days) 


~mstring This message string will be included in 


the warning generated by the —W 
option. The default message is 


FILES 


UUCLEANUP (1M) 


—otime Delete other files with an age greater 
than time days. (Default 2 days) 
~ssystem Execute for the specified system spool 


directory only. 


This program is typically started by the shell demon 
uudemon.clean, which, in turn, is started by cron(1M). 


/usr/lib/uucp _— directory with commands used by 
uucleanup internally 
/usr/spool/uucp spool directory 


SEE ALSO 
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cron(1M), uucp(1C), uux(1C). 

MightyFrame Administrator’s Reference Manual. 

Horton, Mark R. How to Read the Network News. 
Columbus, Ohio: AT&T Bell Laboratories, 1984. 


UUCP (1C) 


NAME 

uucp — CTIX system to CTIX system copy 
SYNOPSIS 

uuep [ options | source-files destination-file 
DESCRIPTION 
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the destination-file argument. A file name may be a 
path name on your machine, or it may have the 
following form: 


Uucp copies files named by the source-file arguments to 


system-name!pathname 


where system-name is taken from a list of system names 
recognized by uucp in the /usr/lib/uucp/Systems 
file. The system-name may also be a list of names such 
as 


system-namel!system-namel...!system-name! pathname 

In this case an attempt is made to send the file to the 
destination via the specified route. Be sure that 
intermediate nodes in the route are willing to forward 
information. 


The shell metacharacters ?, *, and [...] in pathname 
will be expanded on the appropriate system. 


Path names may be one of: 
(1) a full pathname; 


(2) a pathname preceded by “user, where user is a 
login name on the specified system and is replaced 
by that user’s login directory; 


(3) a path name preceded by ~/user where user is a 
login name on the specified system and is replaced 
by that user’s directory under PUBDIR; 


(4) anything else is prefixed by the current directory. 


If the result is an erroneous path name for the remote 
system, the copy will fail. If the destination-file is a 
directory, the last part of the source-file name is used. 


Uucp preserves execute permissions across the 
transmission and gives 0666 read and write permissions 
(see chmod(2)). 


The following options are interpreted by uucp: 


—¢ Use the source file when copying out rather than 
copying the file to the spool directory (default). 


~C Force the source file to be copied to the spool 
directory for transfer. 


FILES 


UUCP(1C) 


—d Make all necessary directories for the file copy 
(default). 

-f Do not make intermediate directories for the file 
copy. 

-j Write the job identification ASCII string on the 


standard output. This job identification can be 
used by uusiat to obtain the status or terminate 
a job. 

—m Send mail to the requester when the copy is 
completed. 


—sfile Report status of the transfer to file. 


—nuser Notify user on the remote system that a file was 
sent. 

-r Queue the job, but do not start the file transfer 
process. By default a file transfer process is 
started each time uucp is invoked. 


/usr/spool/uucp spool directory 

/usr/spool/uucppublic/* public directory for receiving 
and sending (PUBDIR) 

/usr/lib/uucp/* other data and program files 


SEE ALSO 


mail(1), uucico(1M), uux(iC). 
MightyFrame Administrator's Reference Manual. 


WARNING 


BUGS 
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The domain of remotely accessible files can (and for 
obvious security reasons, usually should) be severely 
restricted. You will very likely not be able to fetch files 
by pathname; ask a responsible person on the remote 
system to send them to you. For the same reasons you 
will probably not be able to send files to arbitrary path 
names. As distributed, the remotely accessible files are 
those with names that begin /usr/spool/uucppublic 
(equivalent to ~/). 


All files received by wucp will be owned by wuep. 


The —m option will work only for sending files or 
receiving a single file. Receiving multiple files specified 
by special shell characters ?, *, and [...] will not 
activate the —m option. 


UUCPD(1NM) 


NAME 

uucpd — network uucp server 
SYNOPSIS 

/etc/uucpd 
DESCRIPTION 


Uucpd is the network server for CTIX network file 
transfer using the uucp user interface and protocols. It is 
similar to the rshd (1NM) server, except: 

1) The remote socket need not be privileged, and 
2) The shell invoked must be 

/usr /lib/uucp/uucico. 

A network uwucp connection is indicated with the INET 
keyword in /usr/lib/uucp/L.sys. Uucpd is normally 


ata fea 
executed by the startup file, /ete/rc. 


SEE ALSO 


rshd(1N), uucp(1C). 


UUGETTY (1M) 


NAME 
uugetty — set terminal type, modes, speed, and line 
discipline 

SYNOPSIS 
usr petra tbe etty [| —h | I —t timeout ] [ —r ] 
ine [ speed | BU linediee | ae 
Picante dees augetty —e fi 

DESCRIPTION 


Uugetty is getty(1M) altered to allow bidirectional use of 
a line. Uugetty allows users to log in, but if the line is 
free, uuctco(1M), cu(1C), or ct(1C) can use it for dialing 
out or receiving calls. 


The options are identical to getty(1M) options. In 
addition, the -r option causes uugetty to wait to read a 
ane ncn wt thise nratvrantin 


character before sending the login script, ULLUS preventing 
two uugettys from looping. 


The -r option must be used if a uugetty is present on 
both the sending and receiving systems or if the calling 
system uses an intelligent modem. When the —r option 
is used, several carriage return characters may be 
required to elicit the login message; human users will be 
able to handle this slight inconvenience. The 
expect/send sequence used by uucico(1M) must be 
altered in the /usr/lib/uucp/Systems file to include 
the additional carriage return characters and pauses; for 
example: 


” \p\d\r\d\r\d ogin:--ogin: systenmane assword password 
When cu(1C) or wuctco(1M) is invoked, it creates a lock 
file that prevents users from logging in at the device 
while the process is running. 

EXAMPLE 
The following /etc/inittab entry can be used for an 
intelligent modem or a direct line: 
002:2:respawn:/usr/lib/uucp/uugetty -r -t 60 tty002 1200 


FILES 
/etc/gettydefs 
/etc/issue 
/usr/lib/uucp/Devices 
/usr/spool/locks/LCK.* 
see MEN(IC), ev(10) (1M), init(1M), 1) (1M) 
ct(1C), cu(1C), getty(1M), init(1M), login(1), uucico(1M), 
ioctl(2 ), getty defs(4), inittab(4), tty(7). 
MightyFrame Administrator’s Reference Manual. 
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NAME 

uulog — output logfile information 
SYNOPSIS 

uulog { options | [—ssystem 

uulog | options } |-fsystem 
DESCRIPTION 


FILES 


Uulog oe a log file of uucp or uuzgt transactions in a 
file usr/spool/uucp/.Log/uucico/ system or 
/usr/spool/uucp/.Log/uuxqt/ system. 


The options cause wulog to print logging information: 


—ssystem Print information about file transfer 
work involving system system. 

—fsystem Execute tail —f of the file transfer log 
for system. 


Other options used in conjunction with the above: 


-x Look in the uuzgt(1M) log file for the 
given system. 


—number Execute a tail command of number 
lines. 


/usr/spool/uucp/.Log/uucico/ system 
/usr/spool/uucp/.Log/uuxqt/ system 


SEE ALSO 
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tail(1), uuep(1C), uux(1C). 
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NAME 

uuname — list UUCP system names 
SYNOPSIS 

uuname [ -1 | 
DESCRIPTION 


Uuname lists the UUCP names of known systems. 
The —1 option returns the name of the local system only. 


FILES 
/usr/lib/uucp/Systems 


SEE ALSO 
uname(1). 
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NAME 


UUSCHED (1M) 


uusched ~ the scheduler for the UUCP system 


SYNOPSIS 


/usr/lib/uucp/uusched [| —x debug_level ] { -—u 
debug_level | 


DESCRIPTION 


FILES 


Uusched is the UUCP scheduler. It is usually started by 
the demon uudemon.hour, which is started by cron(1M). 


The two options may be used for debugging. -—x 
debug_level displays debugging messages from uusched. 
—u_ debug_level is passed as -—x debug_level to 
uuctco(1M). Debug_level is a number between 0 and 9; 
higher numbers give more detailed information. 


To invoke wusched the following entry must be included 
in the /usr/spool/cron/crontabs/uucp file: 


39 * * * * f/usr/lib/uucp/uudemon.hour > /dev/null 


When uusched is invoked, it checks the 
(aur speci uuep directories for files awaiting transfer. 
f uusched encounters a C. (control) file, it invokes 
uuctco(1M) to make the transfer. 


/usr/lib/uucp/uudemon.hour 
/usr/lib/uucp/Systems 
/usr/lib/uucp/Permissions 
/usr/lib/uucp/Devices 
/usr/spool/uucp/* 
/usr/spool/locks/LCK.* 
usr/spool/uucppublic/* 
/usr/spool/cron/crontabs/uucp 


SEE ALSO 
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cron(1M), uucico(iM), uucp(1C), uustat(1C) uux(1C). 
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UUSTAT(1C) 


uustat ~ uucp status inquiry and job control 


SYNOPSIS 
uustat {[—a] or [—m] or |~p] or {[—q] or [—-kjobid] or 


[—r jobid 


uustat (—ssystem| [—uuser| 


DESCRIPTION 
Uustat displays the status of or cancels previously 
specified uucp commands, or provides general status on 
uucp connections to other systems. The following 
options are recognized: 


—a 
—kjobid 


—rjobid 


—ssystem 


—uUuser 


Display all jobs in the queue. 

Kill the uucp request whose job identification 
is jobid. The killed uucp request must 
belong to the person issuing the wustat 
command unless one is the super-user. 

Report the status of accessibility of all 
machines. 

Execute a “ps -flp’’ for all the process-ids 
that are in the lock files. 

List the jobs queued for each machine. Jf a 
status file exists for the machine, its date, 
time and status information are reported. In 
addition, if a number appears in parentheses 
next to the number of C. or X. files, it is the 
age in days of the oldest O./X. file for that 
system. The Retry field represents the 
number of hours until the next possible call. 
The Count is the number of failure attempts. 
NOTE: for systems with a moderate number 
of outstanding jobs, this could take 30 
seconds or more of real-time to execute. 
Rejuvenate jobid. The files associated with 
jgobid are touched so that their modification 
time is set to the current time. This prevents 
the cleanup demon from deleting the job 
until the job’s modification time reaches the 
limit imposed by the demon. 

Report the status of all uucp requests for 
remote system. 

Report the status of all uucp requests issued 
by user. 


ce 


When no options are given, uustaf outputs the status of 
all wucp requests issued by the current user. 


UUSTAT(1C) 


FILES 

/usr/spool/uucp /* 
SEE ALSO 

uucp(1C). 
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spool directories 


UUSUB(1M) 


NAME 

uusub — monitor uucp network 
SYNOPSIS 

/usr/lib/uucp/uusub | options | 
DESCRIPTION 


Uusub defines a uucp subnetwork and monitors the 
connection and traffic among the members of the 
subnetwork. The following options are available: 


—asys Add sys to the subnetwork. 
—~dsys Delete sys from the subnetwork. 


-] Report the statistics on connections. 

-r Report the statistics on traffic amount. 

~f Flush the connection statistics. 

—uhr Gather the traffic statistics over the past hr 
hours. 


~esys Exercise the connection to the system sys. If 
sys is specified as all, then exercise the 
connection to all the systems in the subnetwork. 


The meanings of the connections report are: 
sys #call #ok time #dev #login #nack #other 


where sys is the remote system name, #call is the 
number of times the local system tries to call sys since 
the last flush was done, and #ok is the number of 
successful connections, time is the latest successful 
connect time, #dev is the number of unsuccessful 
connections because of no available device (e.g., ACU), 
#login is the number of unsuccessful connections 
because of login failure, #nack is the number of 
unsuccessful connections because of no response (e.g., 
line busy, system down), and #other is the number of 
unsuccessful connections because of other reasons. 


The meanings of the traffic statistics are: 
sfile sbyte rfile rbyte 


where sfile is the number of files sent and sbyte is the 
number of bytes sent over the period of time indicated in 
the latest uusub command with the —uhr option. 
Similarly, rfile and rbyte are the numbers of files and 
bytes received. 


The command: 
uusub —c all —u 24 


UUSUB(1M) 


is typically started by cron(1M) once a day. 


FILES 
/usr/spool/uucp/SYSLOG _ system log file 


/usr/lib/uucp/L_sub connection statistics 
/usr/lib/wucp/R_sub traffic statistics 
SEE ALSO 


uucp(1C), uustat(1C). 
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NAME 

uuto, uupick — public CTIX-to-CTIX system file copy 
SYNOPSIS 

uuto [| options | source-files destination 

uupick | —s system | 
DESCRIPTION 


Uuto sends source-files to destination. Uuto uses the 

uucp(1C) facility to send files, while it allows the local 

system to control the file access. A source-file name is a 

path name on your machine. Destination has the form: 
system!user 


where system is taken from a list of system names that 
uucp knows about (see uuname). Logname is the login 


name of someone on the specified system. 


Two options are available: 


-—p Copy the source file into the spool directory 
before transmission. 

—-m Send mail to the sender when the copy is 
complete. 


The files (or sub-trees if directories are specified) are sent 
to PUBDIR on system, where PUBDIR is a public 
directory defined in the uwucp source. Specifically the 
files are sent to 


PUBDIR/receive/user/mysystem/files. 


The destined recipient is notified by mail(1) of the 
arrival of files. 


Uuptck accepts or rejects the files transmitted to the 
user. Specifically, uupick searches PUBDIR for files 
destined for the user. For each entry (file or directory) 
found, the following message is printed on the standard 
output: 

from system: [file file-name| [dir dirname] ? 


Uupick then reads a line from the standard input to 
determine the disposition of the file: 


<new-line > Go on to next entry. 

d Delete the entry. 

m [ dir | Move the entry to named directory dir 
(current directory is default). 

a [ dir | Same as m except moving all the files 
sent from system. 

Pp Print the content of the file. 


FILES 


NOTES 


UUTO(1C) 


q Stop. 

EOT (control-d) Same as q. 

{command Escape to the shell to do command. 
= Print a command summary. 


Uupick invoked with the —ssystem option will only 
search the PUBDIR for files sent from system. 


PUBDIR /usr/spool/uucppublic public directory 


In order to send files that begin with a dot (e.g., .profile) 
the files must be qualified with a dot. For example: 
.profile, .prof*, .profil? are correct; whereas *prof*, 
?profile are incorrect. 


SEE ALSO 


mail(1), uuclean(1M), uucp(1C), uustat(1C), uux(1C). 


NAME 


UUTRY(1M) 


Uutry ~— try to contact a remote system with debugging 
on 


SYNOPSIS 


/usr/lib/uucp/Uutry { ~—x debug_level | [{ -r ]| 
system_name 


DESCRIPTION 


FILES 


Uutry is a shell script that is used to invoke wucico(1M) 
to call a remote site. Debugging is turned on; the —x 
option overrides the default debug level (5). The —r 
option causes Uutry to override any minimum retry time 
for the designated system. The debugging output is put 
in the file [tmp /system_name, A tail -f of the 
output is executed. A <RUBOUT> or <BREAK> 
will give control back to the terminal while uueico(1M) 
continues to run, putting its output in the file 
/tmp/system_name. 


usr/lib/uucp/Systems 
(eerie ace /Permissions 
/usr/lib/uucp/Devices 
/usr/lib/uucp /Maxuuxqts 
/usr/spool/uucp/.Status/* 
/usr/spool/uucp/* 
/usr/spool/locks/LCK.* 
/usr/spool/uucppublic /* 
/tmp/system_name 


SEE ALSO 
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uucico(1M), uucp(1C), uux(1C). 
MightyFrame Administrator’s Reference Manual. 


UUX(1C) 


NAME 

uux — CTIX to CTIX remote command execution 
SYNOPSIS 

uux [ options | command-string 
DESCRIPTION 


5/86 


Uux gathers zero or more files from various systems, 
executes a command on a specified system and then 
sends standard output to a file on a specified system. 
Note that for security reasons many installations limit 
the list of commands executable on behalf of an 
incoming request from wuz. 


The command-string is made up of one or more 
arguments that look like a Shell command line, except 
that the command and file names may be prefixed by 
system-name!. A null system-name is interpreted as the 
local system. 


File names may be one of 
(1) a full path name; 


(2) a path name preceded by “azz, where raz is a 
login name on the specified system and is 
replaced by that user’s login directory; 


(3) anything else is prefixed by the current 
directory. 


As an example, the command 
uux “Idiff usg!/usr/dan/filel pwhat/a4/dan/file2 > !~/dan/file.diff” 


gets the filel and file2 files from the ‘“‘usg”’ and “pwhba”’ 
machines, executes a diff command and puts the results 
in file.diff in the local PUBDIR/dan/ directory. 


Any special shell characters, such as <, >, ;, or |, 
should be quoted either by quoting the entire command- 
string, or quoting the special characters as individual 
arguments. 


Uuz will attempt to get all files to the execution system. 
For files that are output files, the file name must be 
escaped with parentheses. For example, the command 


uux alcut -f1 b!/usr/file \(c!/usr/file\) 
get /usr/file from system ‘“b” and send it to system 


‘‘a,” performs a cut command on that file and sends the 
result of the cut command to system “‘c.” 


Uuz notifies you if the requested command on the 
remote system was disallowed. This notification can be 
turned off by the —n option. The response comes by 
remote mail from the remote machine. 


af 





UUX(1C) 


The following options are interpreted by wuz: 


The standard input to uuz is made the standard 
input to the commanda-string. 


—aname 


Use name as the user identification instead of 
the initiator’s user-id. (Notification will be 


el a eee a4 acs 
returned to tne user.) 


—-b Return standard input to the command if the 
exit status is nonzero. 

—¢ Use the source file when copying out rather than 
copying the file to the spool directory (default). 

-C Force the source file to be copied to the spool 
directory for transfer. 

—j Write the job identification ASCII string on the 
standard output. This job identification can be 
used by uustat to obtain the status or terminate 
a job. 

—mfile Report the status of the transfer in file. If file is 
omitted, send mail to the requester when the 
copy is completed. 

—n Send no notification to the user. 

-N Return command completion notification 
unconditionally. 

—p Same as —. The standard input to uur is made 
the standard input to the command-string. 

-r Queue the job, but do not start the file transfer 
process. By default a file transfer process is 
started each time uucp is invoked. 

-2Z Return command completion notification only if 
the command exits with a nonzero exit code. 

FILES 

/usr/spool/uucp/* spool directories 

/usr/lib/uucp/* other data and programs 
SEE ALSO 

uucp(1C). 

MightyFrame Administrator’s Reference Manual. 
BUGS 
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Only the first command of a shell pipeline may have a 
system-name!. All other commands are executed on the 


system of the first command. 


5/86 


UUX(1C) 


The use of the shell metacharacter * will probably not 
do what you want it to do. The shell tokens << and 
>> are not implemented. 


UUXQT (1M) 


NAME 
uuxqt — execute remote command requests 
SYNOPSIS 
/usr/lib/uucp/uuxqt [ -s system | [| -x 


debug_level | 


DESCRIPTION 


FILES 


Uuzqt executes the remote job requests from remoie 
systems that are generated by the uuz(1C) command. 
(Mail uses uuz(1C) for remote mail requests.) It searches 
the spool directories looking for X. files. For each one, it 
checks whether all the required data files are available 
and accessible and if the commands are executable by 
the requesting system. The Permissions file is used to 
validate file accessibility and command _ execution 
permission. 


/usr/lib/uucp/Permissions 
/usr/lib/uucp/Maxuuxqts 
/usr/spool/uucp/* 
/usr/spool /locks/LCK.* 


SEE ALSO 
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uucico(1M), uucp(1C), uustat(1C), uux(1C). 
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NAME 

val — validate SCCS file 
SYNOPSIS 

val — 

val |[-s] |—-rSID] [-mname] [-ytype] files 
DESCRIPTION 


Val determines if the specified file is an SCCS file 
meeting the characteristics specified by the optional 
argument list. Arguments to val may appear in any 
order. The arguments consist of keyletter arguments, 
which begin with a —, and named files. 


Val has a special argument, —, which causes reading of 
the standard input until an end-of-file condition is 
detected. Each line read is independently processed as if 
it were a command line argument list. 


Val generates diagnostic messages on the standard 
output for each command line and file processed and also 
returns a single 8-bit code upon exit as described below. 


The keyletter arguments are defined as follows. The 
effects of any keyletter argument apply independently to 
each named file on the command line. 


-8 The presence of this argument 
silences the diagnostic message 
normally generated on the 
standard output for any error that 
is detected while processing each 
named file on a given command 
line. 


—rsID The argument value SID (SCCS 
IDentification String) is an SCCS 
delta number. A check is made to 
determine if the SID is ambiguous 
e. g., rl is ambiguous because it 
physically does not exist but 
implies 1.1, 1.2, etc., which may 
exist) or invalid (e. g., r1.0 or 
ri.1.0 are invalid because neither 
case can exist as a valid delta 
number). If the SID is valid and 
not ambiguous, a check is made to 
determine if it actually exists. 


~—mname The argument value name is 
compared with the SCCS %M% 
keyword in file. 
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—ytype The argument value fype is 
compared with the SCCS %Y% 
keyword in file. 


The 8-bit code returned by val is a disjunction of the 
possible errors, i. e., can be interpreted as a bit string 
where (moving from left to right) set bits are interpreted 
as follows: 

bit O = missing file argument; 

bit 1 = unknown or duplicate keyletter argument; 

bit 2 = corrupted SCCS file; 

bit 3 = cannot open file or file not SCCS; 

bit 4 = SID is invalid or ambiguous; 

bit 5 = SID does not exist; 

bit 6 = %Y%, —y mismatch; 

bit 7 = %M%, ~m mismatch; 
Note that val can process two or more files on a given 
command line and in turn can process multiple command 
lines (when reading the standard input). In these cases 
an aggregate code is returned — a logical OR of the 
codes generated for each command line and file 
processed. 


SEE ALSO ) 
admin(1), delta(1), get(1), help(1), prs(1). = 
DIAGNOSTICS | 
Use help(1) for explanations. | 


BUGS 
Val can process up to 50 files on a single command line. 
Any number above 50 will produce a core dump. 
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NAME 
ve — version control 

SYNOPSIS 
ve (-a] [-t] [-ecchar] [-s] [keyword=value 
keyword=value 

DESCRIPTION 


The ve command copies lines from the standard input to 
the standard output under control of its arguments and 
control statements encountered in the standard input. In 
the process of performing the copy operation, user 
declared keywords may be replaced by their string value 
when they appear in plain text and/or control 
statements. 


The copying of lines from the standard input to the 
standard output is conditional, based on tests (in control 
statements) of keyword values specified in control 
statements or as ve command arguments. 


A control statement is a single line beginning with a 
control character, except as modified by the —t keyletter 
(see below). The default control character is colon (:), 
except as modified by the —c keyletter (see below). 
Input lines beginning with a backslash (\) followed by a 
control character are not control lines and are copied to 
the standard output with the backslash removed. Lines 
beginning with a backslash followed by a non-control 
character are copied in their entirety. 


A keyword is composed of 9 or less alphanumerics; the 
first must be alphabetic. A value is any ASCII string 
that can be created with ed(1); a numeric value is an 
unsigned string of digits. Keyword values may not 
contain blanks or tabs. 


Replacement of keywords by values is done whenever a 
keyword surrounded by control characters is encountered 
on a version control statement. The —a keyletter (see 
below) forces replacement of keywords in all lines of 
text. An uninterpreted control character may be 
included in a value by preceding it with \. If a literal \ 
is desired, then it too must be preceded by \. 


Keyletter Arguments 


a Forces replacement of keywords 
surrounded by control characters 
with their assigned value in all 
text lines and not just in ve 
statements. 
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—t All characters from the beginning 
of a line up to and including the 
first tab character are ignored for 
the purpose of detecting a control 
statement. If one is found, all 
characters up to and including the 
tab are discarded. 


—echar Specifies a control character to be 
used in place of :. 


-8 Silences warning messages (not 
error) that are normally printed 
on the diagnostic output. 


Version Control Statements 
:dcl keyword|, ..., keyword] 


Used to declare keywords. All keywords must be 
declared. 


:asg keyword=value 


Used to assign values to keywords. An asg 
statement overrides the assignment for the 
corresponding keyword on the ve command line 
and all previous asg’s for that keyword. Keywords 
declared, but not assigned values have null values. 


sif condition 


send 


Used to skip lines of the standard input. If the 
condition is true all lines between the tf statement 
and the matching end statement are copied to the 
standard output. If the condition is false, all 
intervening lines are discarded, including control 
statements. Note that intervening if statements 
and matching end statements are recognized solely 
for the purpose of maintaining the proper tf-end 


matching. 

The syntax of a condition is: 

<cond > s= [ "not” ] <or> 

<or> s== <and> | <and> "|" <or> 

<and> = <exp> | <exp> "&" 
<and> 

<exp > n= "(" <or> ”)" | <value> 
<op> <value> 

<op> 2 "=" | Ue | now | ">" 

<value> == <arbitrary ASCII string> | 


<numeric string > 


sstext 


son 
soff 
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The available operators and their meanings are: 


equal 

not equal 

and 

or 

greater than 

less than 

used for logical groupings 

may only occur immediately after 
the tf, and when present, inverts 
the value of the entire condition 


The > and < operate only on unsigned integer 
values (e.g., : 012 > 12 is false). All other 
operators take strings as arguments (e.g., : 012 != 
12 is true). The precedence of the operators (from 
highest to lowest) is: 

=!=>< all of equal precedence 

& 


AV_®T || 


yo 
oN 


co 


Parentheses may be used to alter the order of 
precedence. 

Values must be separated from operators or 
parentheses by at least one blank or tab. 


Used for keyword replacement on lines that are 
copied to the standard output. The two leading 
control characters are removed, and keywords 
surrounded by control characters in text are 
replaced by their value before the line is copied to 
the output file. This action is independent of the 
—a keyletter. 


Turn on or off keyword replacement on all lines. 


sctl char 


Change the control character to char. 


smsg message 


Prints the given message on the diagnostic output. 


:err message 


SEE ALSO 


Prints the given message followed by: 

ERROR: err statement on line ... (915) 
on the diagnostic output. Ve halts execution, and 
returns an exit code of 1. 


ed(1), help(1). 
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DIAGNOSTICS 
Use help(1) for explanations. 


EXIT CODES 
0 — normal 
1 ~— any error 


vi(1) 


NAME 
vi ~ screen-oriented (visual) display editor based on ex 


SYNOPSIS 
Tee) ae eee | 


[ +command | name ... 


view | -t tag | [ -r file | [ -1] [ -wn][-R ]} 
[ +command | name ... 


vedit | -t tag | { -r file ] [ -l1] [| -wn][-R ] 
[ +command |] name ... 

DESCRIPTION 
Vi (visual) is a display-oriented text editor based on an 
underlying line editor ez(1). It is possible to use the 
command mode of ez from within vs and vice-versa. 


When using vt, changes you make to the file are 
reflected in what you see on your terminal screen. The 
position of the cursor on the screen indicates the position 
within the file. 


INVOCATION 
The following invocation options are interpreted by v1: 
~—t tag Edit the file containing the tag and 
position the editor at its definition. 
—rfile Recover file after an editor or system 


crash. If file is not specified a list of all 
saved files will be printed. 


-l LISP mode; indents appropriately for 
lisp code, the () {} [[ and }} commands 
in vt and open are modified to have 


meaning for ltsp . 


—wn Set the default window size to n. This 
is useful when using the editor over a 
slow speed line. 


-R Read only mode; the readonly flag is 
set, preventing accidental overwriting of 
the file. 

+command The specified ex command is 


interpreted before editing begins. 
The name argument indicates files to be edited. 


The view invocation is the same as vt except that the 
readonly flag is set. 


The vedit invocation is intended for beginners. The 
report flag is set to 1, and the showmode and novice 


2s 
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flags are set. These defaults make it easier to get started 
learning the editor. 


VI MODES 


Command 


Input 


Last line 


Normal] and initial mode. Other modes 
return to command mode_ upon 
completion. ESC (escape; GO on 
Convergent Technologies terminals) is 
used to cancel a partial command. 


Entered by aiAIToOcCsSR. 
Arbitrary text may then be entered. 
Input mode is normally terminated with 
ESC character, or abnormally with 
interrupt. 


Reading input for: / ? or !; terminate 
with to execute, interrupt to 
cancel. 


COMMAND SUMMARY 
The following sequences represent special keys: 


ESC Escape key. GO on Convergent Technologies 


a 


z 


CR 
f 


terminals. 

Control key: hold down the CTRL key 
(CODE on Convergent Technologies terminals) 
and press z. 


RETURN or CARRIAGE RETURN key. 


Circumflex “), On _ teletypewriter-style 
terminals, usually an up arrow (f). 


Sample commands 


«-|t- arrow keys move the cursor 
hjkl same as arrow keys 
itextESC insert tert 

cwnewESC change word to new 
easESC pluralize word 

x delete a character 

dw delete a word 

dd delete a line 

3dd ... 3 lines 

u undo previous change 
ZZ exit vi, saving changes 
:qiICR quit, discarding changes 
/textCR search for tezt 

‘U *D scroll up or down 

sex emdCR any ex or ed command 
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Counts before vi commands 
Numbers may be typed as a prefix to some commands. 
They are interpreted in one of these ways. 


line/column number z G 

scroll amount ‘D * 

repeat effect most of the rest 

Interrupting, canceling 
ESC end insert or incomplete cmd 
or (delete or rubout) interrupts 
“L reprint screen if “? scrambles it 
“R reprint screen if “L is > key 
File manipulation 

:wCR write back changes 
:qCR quit 
:qiCR quit, discard changes 
re nameCR edit file name 
:e!CR reedit, discard changes 
:e + nameCR edit, starting at end 
se +nCR edit starting at line n 
:e #CR edit alternate file 
. synonym for :e # 
sw nameCR write file name 
sw! nameCR overwrite file name 
:shCR run shell, then return 
s!cmdCR run emd, then return 
nCR edit next file in arglist 
m argsCR specify new arglist 
“G show current file and line 
ita tagCR to tag file entry tag 


tta, following word is tag 
In general, any ez or ed command (such as substitute or 
global) may be typed, preceded by a colon and followed 
by a OR. 
Positioning within file 
e forward screen 


“B backward screen 
“‘D scroll down half screen 
U scroll up half screen 
G go to specified line (end default) 
/ pat next line matching pat 
?pat prev line matching pat 
n repeat last / or? 
N reverse last / or ? 
pat/+n nth line after pat 
?patf—n nth line before pat 
next section/function 
previous section/function 
beginning of sentence 
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) end of sentence 
beginning of paragraph 

| end of paragraph 

© find matching ( ) { or } 

Adjusting the screen 

*L clear and redraw 
“R retype, eliminate @ lines 
zCR redraw, current at window top 
z—-CR ... at bottom 
z CR ... at center 
/pat/z-CR pat line at bottom 
zn CR use n line window 
*E scroll window down 1 line 
“Y scroll window up 1 line 


Marking and returning 
a move cursor to previous context 
.. at first non-white in line 


mz mark current position with letter z 
‘2 move cursor to mark z 
“Zz ... at first non-white in line 


Line positioning 


H top line on screen 

L last line on screen 

M middle line on screen 

+ next line, at first non-white 

- previous line, at first non-white 
CR return, same as + 

Jorj next line, same column 

ft ork previous line, same column 


Character positioning 
: first non white 


0 beginning of line 

$ end of line 

hor— forward 

lor — backwards 

“H same as «— 

space same as —> 

fz find z forward 

Fz f backward 

tz up to z forward 

Tz back up to z 

; repeat last f F t or T 
inverse of ; 

E to specified column 

6 find matching ( { ) or } 
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Words, sentences, paragraphs 


w 


Hoe"? o 


word forward 

back word 

end of word 

to next sentence 

to next paragraph 

back sentence 

back paragraph 

blank delimited word 

back W 

to end of W = 


Commands for LISP Mode 


Forward s-expression 

... but do not stop at atoms 
Back s-expression 

... but do not stop at atoms 


Corrections during insert 
“H 


“W 
erase 


kill 


erase last character 

erase last word 

your erase, same as “H 

your kill, erase input this line 

quotes “H, your erase and kill 

ends insertion, back to command 

interrupt, terminates insert 

backtab over autoindent 

kill autotndent, save for next 
... but at margin next also | 
quote non-printing character | 


Insert and replace 


O° “> es 


rr 
RteztESC 
Operators 


append after cursor 

insert before cursor 

append at end of line 

insert before first non-blank 
open line below 

open above 

replace single char with z 
replace characters 


Operators are followed by a cursor motion, and affect all 
text that would have been moved over. For example, 
since w moves over a word, dw deletes the word that 
would be moved over. Double the operator, e.g. dd to 
affect whole lines. 


e 
yY 
< 


delete 

change 

yank lines to buffer 
left shift 


Misc 
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> right shift 
filter through command 
indent for LISP 


! 
ellaneous Operations 

Cc change rest of line 4) 
D delete rest of line ( $) 
8 substitute chars (e. 

Ss substitute lines (ce 

J join lines 

x delete characters A 
x ... before cursor (dh) 
Y yank lines (yy) 


Yank and Put 


Put inserts the text most recently deleted or yanked. 
However, if a buffer is named, the text in that buffer is 
put instead. 


Pp put back text after cursor 
P put before cursor 

"zp put from buffer z 

"xy yank to buffer z 

"ad delete into buffer z 


Undo, Redo, Retrieve 


u undo last change 

U restore current line 

, repeat last change 
“dp retrieve d’th last delete 


AUTHOR 


Vi and ez were developed by The University of 
California, Berkeley, California, Computer Science 
Division, Department of Electrical Engineering and 
Computer Science. 


SEE ALSO 


ex (1). 
oy Programmer’s Guide. 


CAVEATS AND BUGS 


Software tabs using “T work only immediately after the 
autoindent. 


Left and right shifts on intelligent terminals do not make 
use of insert and delete character operations in the 
terminal. 


There should be an interactive help facility and a tutorial 
suited for beginners. 


Due to export restrictions, encryption features are not 
available outside the United States. 
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NAME 

volcopy, labelit — copy file systems with label checking 
SYNOPSIS 

/etc/voleopy options} fsname speciall volnamel 

special2 volname2 

/etc/labelit special { fsname volume [ —n | | 
DESCRIPTION 


5/86 


Voleopy makes a literal copy of the file system using a 

blocksize matched to the device. Options are: 

-a invoke a verification sequence requiring a 
positive operator response instead of the 
standard 10-second delay before the copy is 
made, 

-8 (default) invoke the DEL if wrong verification 
sequence. 

—to The output file is a disk section (also called slice 
or partition), but is to be treated like a tape. 

—ti The input file is a disk section, but is to be 
treated like a tape. 


Other options are used only with tapes: 

—bpidensity bits-per-inch (i.e., 800/1600/6250 

—feetsize size of reel in feet (i.e., 1200/2400), 

—reelnum _ beginning reel number for a restarted copy, 

—buf use double buffered I/O. 

—-Q Use —bpi and —feet values appropriate for 
quarter-inch tape cartridge. 


The —t option puts tape headers on media other than 
tape. If —ti or —to is specified, the “reel” capacity is 
simply the size of the disk section; the ‘“‘reel’’ is assumed 
to be on a removable disk, such as a floppy. 


For a true tape such as half-inch reel-to-reel or quarter- 
inch cartridge, capacity is derived from tape length and 
density. The program requests length and density 
information if it is not given on the command line or is 
not recorded on an input tape label. If the file system is 
too large to fit on one reel, volcopy will prompt for 
additional reels. Labels of all reels are checked. Tapes 
may be mounted alternately on two or more drives. If 
volcopy is interrupted, it will ask if the user wants to 
quit or wants a shell. In the latter case, the user can 
perform other operations (e.g., labelit) and return to 
volcopy by exiting the new shell. 


The fsname argument represents the mounted name 
(e.g.: root, ul, etc.) of the filsystem being copied. 
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The spectal should be the physical disk section or tape 
(e.g., /dev/rdsk/c0d0s5, /dev/rmt0, etc.). 


The volname is the physical volume name (e.g.: pk3, 
t0122, etc.) and should match the external label sticker. 
Such label names are limited to six or fewer characters. 
Volname may be — to use the existing volume name. 


Speciall and volnamel are the device and volume from 
which the copy of the file system is being extracted. 
Spectal2 and volname? are the target device and volume. 


Fsname and volname are recorded in the last 12 
characters of the superblock (char fsname[6], 
volname(6]}). 


Labelit can be used to provide initial labels for 
unmounted disk or tape file systems. With the optional 
arguments omitted, labelit prints current label values. 
The —n option provides for initial labeling of new tapes 
only (this destroys previous contents). 


FILES 
/etc/log/filesave.log a record of file systems/volumes 
copied 
EXAMPLE 
The following command backs up the root file system to 
a tape: 
voleopy —a root /dev/rdsk/c0d0s1 dO /dev/rmt0 epochi 
SEE ALSO 
sh(1), fs(4). 
WARNINGS 
Labelit applied to a mounted file system will appear to 
succeed, but the next reboot or umount will remove the 
label. 
BUGS 
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Only device names beginning /dev/rmt are 
automatically treated as tapes. Tape record sizes are 
determined both by density and by drive type. Records 
are 5,120 bytes long at 800 and 1600 bits-per-inch, and 
25,600 bytes long at 6250 bits-per-inch. 
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NAME 
wait — await completion of process 

SYNOPSIS 
wait 

DESCRIPTION 
Wait until all processes started with & have completed, 
and report on abnormal terminations. 
Because the watt(2) system call must be executed in the 
parent process, the shell itself executes watt, without 
creating a new process. 

SEE ALSO 
sh(1), wait(2). 

BUGS 


Not all the processes of a 3- or more-stage pipeline are 
children of the shell, and thus cannot be waited for. 


NAME 


WALL (1M) 


wall — write to all users 


SYNOPSIS 


/etc/wall 


DESCRIPTION 


FILES 


Wall reads its standard input until an end-of-file. It 
then sends this message to all currently logged-in users 
preceded by: 


Broadcast Message from... 


It is used to warn all users, typically prior to shutting 
down the system. 


The sender must be super-user to override any 
protections the users may have invoked (see mesg(1)). 


/dev /tty* 


SEE ALSO 


mesg(1), write(1). 


DIAGNOSTICS 


“Cannot send to ...”” when the open on a user’s tty file 
fails. 
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NAME 
we — word count 


SYNOPSIS 
we | —lwe | [ names | 


DESCRIPTION 
We counts lines, words, and characters in the named 
files, or in the standard input if no names appear. It 
also keeps a total count for all named files. A word is a 
maximal string of characters delimited by spaces, tabs, 
or new-lines. 


The options I, w, and ec may be used in any combination 
to specify that a subset of lines, words, and characters 
are to be reported. The default is —lwe. 


When names are specified on the command line, they 
will be printed along with the counts. 
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NAME 
what — identify SCCS files 
SYNOPSIS 
what [-s] files 
DESCRIPTION 
What searches the given files for all occurrences of the 
pattern that get(1) substitutes for %Z% (this is @(#) at 
this printing) and prints out what follows until the first 
", >, new-line, \, or null character. For example, if the 
C program in file f.c contains 
char ident[{] = ” @(#)identification information ”; 
and f.c is compiled to yield f.o and a.out, then the 
command 
what f.c f.o a.out 
will print 
fie: 
identification information 
f.o: 
identification information 
a.out: 
identification information 
What is intended to be used in conjunction with the 
command get(1), which automatically inserts identifying 
information, but it can also be used where the 
information is inserted manually. Only one option 
exists: 
8 Quit after finding the first occurrence of pattern 
in each file. 
SEE ALSO 
get(1), help(1). 
DIAGNOSTICS 
Exit status if - if any matches are found, otherwise 1. 
Use help(1) for explanations. 
BUGS 


It is possible that an unintended occurrence of the 
pattern @(#) could be found just by chance, but this 
causes no harm in nearly all cases. 


NAME 


WHO (1) 


who — who is on the system 


SYNOPSIS 


who { —uTHIpdbrtasgq | [ file | 
who am i 
who am I 


DESCRIPTION 


Who can list the user’s name, terminal line, login time, 
elapsed time since activity occurred on the line, and the 
process-ID of the command interpreter (shell) for each 
current CTIX system user. It examines the /ete/utmp 
file to obtain its information. If file is given, that file is 
examined. Usually, file will be /ete/wtmp, which 
contains a history of all the logins since the file was last 
created. 


Who with the am i or am I option identifies the 
invoking user. 


Except for the default —s option, the general format for 
output entries is: 


name state} line time activity pid 
[comment] [exit] 


With options, who can list logins, logoffs, reboots, and 
changes to the system clock, as well as other processes 
spawned by the int process. These options are: 


-u_ This option lists only those users who are 
currently logged in. The name is the user’s login 
name. The ltne is the name of the line as found 
in the directory /dev. The time is the time that 
the user logged in. The acttvity is the number of 
hours and minutes since activity last occurred on 
that particular line. A dot (.) indicates that the 
terminal has seen activity in the last minute and 
is therefore “current”. If more than twenty-four 
hours have elapsed or the line has not been used 
since boot time, the entry is marked old. This 
field is useful when trying to determine whether a 
person is working at the terminal or not. The pid 
is the process-ID of the user’s shell. The comment 
is the comment field associated with this line as 
found in /ete/inittab (see inittab(4)). This can 
contain information about where the terminal is 
located, the telephone number of the dataset, type 
of terminal if hard-wired, etc. 


-T This option is the same as the —u option, except 
that the state of the terminal line is printed. The 
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—p 


—-b 
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state describes whether someone else can write to 
that terminal. A + appears if the terminal is 
writable by anyone; a — appears if it is not. 
Root can write to all lines having a + or a — in 
the state field. If a bad line is encountered, a ? is 
printed. 


This option lists only those lines on which the 
system is waiting for someone to login. The name 
field is LOGIN in such cases. Other fields are the 
same as for user entries except that the state field 
does not exist. 


This option will print column headings above the 
regular output. 

This is a quick who, displaying only the names 
and the number of users currently logged on. 
When this option is used, all other options are 
ignored. 


This option lists any other process which is 
currently active and has been previously spawned 
by intt. The name field is the name of the 
program executed by mst as found in 
pote/mnieeat The state, line, and activity fields 
ave no meaning. The comment field shows the 
id field of the line from /etc/inittab that 
spawned this process. See intttab(4). 


This option displays all processes that have 
expired and not been respawned by intt. The exit 
field appears for dead processes and contains the 
termination and exit values (as returned by 
watt(2)), of the dead process. This can be useful 
in determining why a process terminated. 


This option indicates the time and date of the last 
reboot. 


This option indicates the current run-level of the 
intt process. Following the run-level and date 
information are three fields which indicate the 
current state, the number of times that state was 
previously entered, and the previous state. 


This option indicates the last change to the 
system clock (via the date(1) command) by root. 
See su(1). 


This option processes /etc/utmp or the named 
file with all options turned on. 


This option is the default and lists only the name, 
line and time fields. 
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FILES 
/etc/utmp 
/etc/wtmp 
/etc/inittab 


SEE ALSO 
init(1M) date(1), login(1), mesg(1), su(1), wait(2), 
inittab(4), utmp(4). - 
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NAME 
whodo — who is doing what 


SYNOPSIS 
/etc/whodo 


DESCRIPTION 
Whodo produces merged, reformatted, and dated output 
from the who(1) and ps(1) commands. 
FILES 
etc/passwd 
SEE ALSO 
ps(1), who(1). 


NAME 


WM(1) 


wm — window management 


SYNOPSIS 


exec /usr/local/bin/wm [| -k ][ -s ]{ -- | 
[ passparam | 


DESCRIPTION 


Wm is the window manager. It provides services to 
application programs running under its control and to 
users using terminals under its control. The window 
manager can divide the terminal screen into windows 
that the user can use like separate terminals. Other 
services include placement, size, scrolling, and 
synchronization of windows. Wm requires a Convergent 
Technologies Programmable Terminal or Graphics 
Terminal on a cluster line. The window manager must 
be running for the window management library functions 
to work. 


The window manager is normally executed in place of 
the user’s login shell by the exec command in 
/etc/profile or the user’s own .profile. The window 
manager then executes the user’s shell each time the user 
splits a window. The SHELL environment variable 
(normally set by login(1M)to /bin/sh) provides the full 
pathname of the initial program run in the windows. 


When wm starts, the user sees four regions on the screen, 
going from top to bottom: 


e A message line. A single line, always at the top of 
the screen. It holds messages and prompts from 
application programs. 


eA tag line. A single line, always above each 
window, which labels the particular application 
program or display that is active in the window. 


e The window. The main display area used by 
programs. Text input and output to the shell or an 
application program goes here. The window is a 
window into a virtual display. An application 
program can use the virtual display as a 28-line 
screen, regardless of the size of the window. The 
virtual display is usually larger than the window. 
Normally the window manager automatically 
positions the window over the part of the virtual 
display that contains the cursor. If the user 
program moves the cursor to a part of the virtual 
display not in the window, the window manager 
scrolls the window until the cursor is visible again. 
The user can also scroll the display (see below). 
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e The funciton key line. A single line, always at the 
bottom of the screen, that labels the function keys 
for the currently active window. 


Wm accepts user commands activated by the ACTION 
key; such commands are not seen by the user program. 
Use the ACTION key like the CODE or SHIFT keys: hold 
down the ACTION key and press the other key used with 
it. Holding down the ACTION key changes the function 
key line to show how ACTION changes the meanings of 
the function keys. 


Here are the valid wm user commands: 


ACTION-F10 (SPLIT) 
Split the active window, creating a new window. 
The new window and its tag line replace the 
bottom half of the window being split. Any 
program running in the old window is 
unaffected. The virtual display of the old 
window is unchanged, though less of it is visible. 
The user shell then starts up in the new window. 


The new window is active; all other windows are 
inactive. Programs running in inactive windows 
continue to run, but input calls will not return 
until the user reactivates the window and types 
something. Keyboard input goes to the active 
window. 


Each window, whether active on inactive, has its 
own message line, function key line, and cursor, 
but the terminal only displays them if they 
belong to the active window. (Application 
programs can also make the cursor invisible.) If 
an application program in a inactive window 
writes to the message line, the message is not 
visible until you make that window active again. 


On Programmable Terminals the active 
window’s tag line is displayed full intensity, with 
the other tag lines displayed half intensity. On 
Graphics Terminals the active window’s tag line 
is displayed in bold, with the other tag lines 
displayed without bold. 


When the SPLIT key creates a new window, wm 
automatically provides a program to run in the 
window. The program is a process group leader; 
the new process group is controlled by the new 
window and has terminal file descriptors 
associated with the new window. The program 
is a shell unless wm was run with the —k option. 
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When all processes in the process group die, wm 
automatically closes the window. 


Programs can also have the window manager create 
windows, using wmop(3X). The window manager does 
not automatically provide programs for such windows. 


The SPLIT key becomes inoperative if the 
terminal already displays its maximum number 
of windows or if a user program has disabled 
window splitting. 
ACTION-F9 (BELOW) 

The window below the active window becomes 
the active window with the old active window 
becoming inactive. The new active window 
takes over the message line and the function key 
line, and its cursor becomes visible. 


ACTION-| is the same as ACTION-F9. 


ACTION-F8 (ABOVE) 
The window above the active window becomes 
the active window. ACTION-f is the same as 
ACTION-F8. 


ACTION-n 
Activate window n, where n is a number from IL 
to 4. A window’s number is assigned when it’s 
first created, with a new window getting the 
lowest unused number. Unless erased by a user 
program, the window number is displayed on the 
left end of the tag line. 


ACTION-F7 (SWAP |) 
he active window and the window below it 
trade places. 


ACTION-F6 (SWAP 1) 
The active window and the window above it 
trade places. 


ACTION-F5 (SHRINK) 
The active window decreases in size by 1 line. 
Ignored if the window is already 0 lines long 
(only the tag line visible). 


ACTION-SHIFT-F5 
The active window decreases in size by 4 lines. 
If the window is already less than 4 lines long, it 
becomes 0 lines long. 


ACTION-CODE-F5 
The active window becomes 0 lines long. 
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Shrinking the top window increases the size of the 
window below; shrinking any other window increases the 
size of the window above. 


ACTION-F4 (GROW) 
The active window increases in size by 1 line. 
Ignored if the other windows are all 0 lines long. 


ACTION-SHIFT-F4 
The active window increases in size by 4 lines. 
If the other windows don’t have 4 lines to spare, 
the active window increases until all other 
windows are 0 lines long. 


ACTION-F3 (MAX) 

ACTION-CODE-F4 
The active window increases in size until all 
other windows are 0 lines long. 


Growing the top window decreases the size of the 
window below; growing any other window window 
decreases the size of window below. If the window that 
would otherwise shrink is already 0 lines long, the next 
window shrinks. If all the windows below the second or 
third window are 0 lines long, space comes from the 
windows above. 


ACTION-SCROLL UP 
The active window is scrolled up a line. Ignored 
if the window already shows the very bottom of 
the virtual display or if the cursor is on the 
window’s top line. 

ACTION-SCROLL DOWN 
The active window is scrolled down a line. 
Ignored if the window already shows the very 
top of the virtual display or if the cursor is on 
the window’s bottom line. 


Wm understands the following options: 


-k Run keyprompt(1) in the first window 
and in manually-created (SPLIT key) 
windows instead of the shell. 

-8 Disable the SPLIT key. The user cannot 
create new windows, but programs 
running under wm still can. 

—¢ Run the CTIX Office Applications 
Interface in the first window instead of 
the shell; disable the SPLIT key (as with 
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—s above). The Office Applications 
Interface is a separate product and must 
have been previously installed for this 
option to work. 


— End of wm_ options. Subsequent 
parameters are passed to the shell, 
keyprompt, or the Office Applications 
Interface, even if they begin with a dash 


Parameters other than options are passed unchanged to 
programs executed by wm. 


Wm uses or sets the following environment parameters: 


TERM If already set, wm passes it unchanged 
to its own children. If not already set, 
wm has the terminal identify itself and 
sets TERM to pt or gt accordingly. 


SHELL Name of the shell’s executable file. If 
—k and —e aren’t specified, SHELL is 
the initial program in the first window 
and in user-created (SPLIT windows. If 
-k or —c is specified, SHELL must 
still have a useful value, such as 
/ bin/sh. 

KEYPROMPT 
The name of keyprompt’s executable 
file. If KEYPROMPT is not defined, 
/usr/oa/keyprompt is used. 


CTIXOA The name of the Office Application 
Interface’s executable file. If CTIXOA 
is not defined, /usr/oa/ctixoa is used. 


TERMPARM If the user’s terminal is a Graphics 
Terminal, wm reads the 32 bytes in the 
terminal’s EAPROM, codes them in 
hexadecimal, and provides its children 
with those 64 digits in TERMPARM. 


SEE ALSO 
sh(1). 

WARNING 
If a program quickly outputs two things at the virtual 
display’s top and bottom, the user can easily miss one of 
them. This normally is the fault of programs, originally 
designed for terminals without window features, that use 
the bottom line as a message line. Use the terminal 
message line instead. 
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BUGS 
Write(1) messages appear only in the first window. 


Some csh(1) features may not work with wm. 


NAME 


WRITE(1) 


write — write to another user 


SYNOPSIS 


write user [ line | 


DESCRIPTION 


Write copies lines from your terminal to that of another 
user. When first called, it sends the message: 


Message from yourname (tty???) [ date]... 


to the person you want to talk to. When it has 
successfully completed the connection, it also sends two 
bells to your own terminal to indicate that what you are 
typing is being sent. 


The recipient of the message should write back at this 
point. Communication continues until an end of file is 
read from the terminal or an interrupt is sent, or the 
recipient has executed "mesg n”. At that point write 
writes EOT on the other terminal and exits. 


If you want to write to a user who is logged in more than 
once, the line argument may be used to indicate which 
line or terminal to send to (e.g., ttyO00); otherwise, the 
first writable instance of the user found in /ete/utmp is 
assumed and the following message posted: 


user is logged on more than one place. 
You are connected to “terminal”. 
Other locations are: 

terminal 


Permission to write may be denied or granted by use of 
the mesg/1) command. Writing to others is normally 
allowed by default. Certain commands, in particular 
nroff(1) and pr(1) disallow messages in order to prevent 
interference with their output. However, if the user has 
super-user permissions, messages can be forced onto a 
write-inhibited terminal. 


If the character ! is found at the beginning of a line, 
write calls the shell to execute the rest of the line as a 
command. 


The following protocol is suggested for using write: when 
you first wrtte to another user, wait for them to wrtte 
back before starting to send. Each person should end a 
message with a distinctive signal (i.e., (0) for ‘‘over’”’) so 
that the other person knows when to reply. The signal 
(oo) (for ‘over and out”) is suggested when conversation 
is to be terminated. 
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FILES 

/etc/utmp to find user 

/bin/sh to execute ! 
SEE ALSO 

mail(1), mesg(1), nroff(1), pr(1), sh(1), who(1). 
DIAGNOSTICS 


“user not logged on” if the person you are trying to 
write to is not logged on. 

“Permission dented” if the person you are trying to 
wrtte to denies that permission (with mesg). 

“Warning: cannot respond, set mesg -y” if your terminal 
is set to mesg n and the recipient cannot respond 
to you. 

“Can no longer write to user” if the recipient has denied 
permission (mesg n) after you had _ started 
writing. 
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NAME 
xargs — construct argument list(s) and execute command 


SYNOPSIS 
xargs [flags] [ command [ initial-arguments | | 


DESCRIPTION 
Xargs combines the fixed intttal-arguments with 
arguments read from standard input to execute the 
specified command one or more times. The number of 
arguments read for each command invocation and the 
manner in which they are combined are determined by 
the flags specified. 


Command, which may be a shell file, is searched for, 
using one’s $PATH. If command is omitted, /bin/echo 
is used. 


Arguments read in from standard input are defined to be 
contiguous strings of characters delimited by one or more 
blanks, tabs, or new-lines; empty lines are always 
discarded. Blanks and tabs may be embedded as part of 
an argument if escaped or quote. Characters enclosed in 
quotes (single or double) are taken literally, and the 
delimiting quotes are removed. Outside of quoted strings 
a backslash (\) will escape the next character. 


Each argument list is constructed starting with the 
inttial-arguments, followed by some number of 
arguments read from standard input (Exception: see ~i 
flag). Flags —i, —-I, and —m determine how arguments 
are selected for each command invocation. When none 
of these flags are coded, the inittal-arguments are 
followed by arguments read continuously from standard 
input until an internal buffer is full, and then command 
is executed with the accumulated args. This process is 
repeated until there are no more args. When there are 
flag conflicts (e.g., —l vs. -—m), the last flag has 
precedence. Flag values are: 


—Inumber Command is executed for each 
non-empty number lines of 
arguments from standard input. 
The last invocation of command 
will be with fewer lines of 
arguments if fewer than number 
remain. A line is considered to 
end with the first new-line unless 
the last character of the line is a 
blank or a _ tab; a trailing 
blank/tab signals continuation 
through the next non-empty line. 
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—ireplstr 


—nnumber 


-t 


-x 
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If number is omitted, 1 is 
assumed. Option —x is forced. 


Insert mode: command is executed 
for each line from standard input, 
taking the entire line as a single 
arg, inserting it in tnsttal- 
arguments for each occurrence of 
replstr. A maximum of 5 
arguments in intttal-arguments 
may each contain one or more 
instances of replstr. Blanks and 
tabs at the beginning of each line 
are thrown away. Constructed 
arguments may not grow larger 
than 255 characters, and option 
—x is also forced. { } is assumed 
for replstr if not specified. 


Execute command using as many 
standard input arguments as 
possible, up to number arguments 
maximum. Fewer arguments will 
be used if their total size is 
greater than stze characters, and 
for the last invocation if there are 
fewer than number arguments 
remaining. If option —x is also 
coded, each number arguments 
must fit in the stze limitation, 
else zargs terminates execution. 


Trace mode: The command and 
each constructed argument list are 
echoed to file descriptor 2 just 
prior to their execution. 


Prompt mode: The user is asked 
whether to execute command each 
invocation. Trace mode (-t) is 
turned on to print the command 
instance to be executed, followed 
by a ?... prompt. A reply of y 
(optionally followed by anything) 
will execute the command; 
anything else, including just a 
carriage return, skips that 
particular invocation of command. 


Causes zargs to terminate if any 
argument list would be greater 
than stze characters; —x 1s forced 
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by the options -i and —]. When 
neither of the options -—i, —I, or 
—n are coded, the total length of 
all arguments must be within the 
size limit. 

—Bsize The maximum total size of each 
argument list is set to size 
characters; size must be a positive 
integer less than or equal to 470. 
If —s is not coded, 470 is taken as 
the default. Note that the 
character count for stze includes 
one extra character for each 
argument and the count of 
characters in the command name. 


—eeofstr Eofstr is taken as the logical end- 
of-file string. Underbar (_) is 
assumed for the logical EOF 
string if —e is not coded. The 
value —e with no eofstr coded 
turns off the logical EOF string 
capability (underbar is taken 
literally). Xargs reads standard 
input until either end-of-file or the 
logical EOF string is encountered. 


Xargs will terminate if either it receives a return code of 
—1 from, or if it cannot execute, command. When 
command is a shell program, it should explicitly eztt (see 
sh(1)) with an appropriate value to avoid accidentally 
returning with —1. 


EXAMPLES 
The following will move all files from directory $1 to 
directory $2, and echo each move command just before 
doing it: 
Is $1 | xargs -i -t mv $1/{} $2/{ } 


The following will combine the output of the 
parenthesized commands onto one line, which is then 
echoed to the end of file log: 


(logname; date; echo $0 $*) | xargs 
>> log 
The user is asked which files in the current directory are 
to be archived and archives them into arch (1.) one at a 
time, or (2.) many at a time. 


1. Is | xargs —p -l ar r arch 
2. Is | xargs —p -1 | xargs ar r arch 


-3- 


XARGS(1) 


The following will execute diff(1) with successive pairs of 
arguments originally typed as shell arguments: 


echo $* | xargs —n2 diff 


SEE ALSO 
sh(1). 


DIAGNOSTICS 
Self-explanatory. 


NAME 


XMSET (1M) 


xmset — set drive parameters for Xylogics 772 half-inch 
tape controller 


SYNOPSIS 


xmset [-b maxmblksz] [—] leode] [-m mceode] [—h 
hcode] [-g gcode] [—o timeout] [-d 0-7] (-i 1| 0] [~s 
low| high} [—x ext] def] [—p] device 

xmset —t drivetype —p device 

xmset —p device 


DESCRIPTION 
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Xmset initializes the Xylogics 772 half-inch tape 
controller for a particular type of tape drive. This is a 
one-time operation for the life of the drive. It never 
needs to be executed again once the parameters have 
been written. Once loaded, the parameters remain 
stored in the 772 nonvolatile memory. 


Xmset is also used to specify to the loadable driver 
software the maximum block size handled by the drive; 
for example, CTIX allows a maximum data transfer of 
128K bytes, but a particular drive may be restricted to a 
block size of 32K bytes. 


Xmset should be executed after loading the half-inch 
tape driver xm with the /ddrv(1M) command. Device is 
/dev/rmt/cldne, where n is the drive number; the 
second ¢ indicates to the driver software that this is a 
special controller command that does not require the 
drive to be on line. Only the specified parameters are 
set or changed. 


The following options are recognized by zmset: 
—p Print the current configuration on sédout. 


—b Inform the loadable driver software that the 
biggest block size the tape drive can handle is 
mazmblksz. 


—t Automatically configure the controller for a 
drivetype drive. Currently supported are Cipher 
M990, F880 and F890 drives. 

—Oo Set the data busy timeout value to timeout. 
This value is in 0.25-second increments. Cipher 
F890 and M990 drives require a timeout value of 
at least 0x7f. 


-i Inhibit/enable parity on writes (1 or 0). Cipher 
drives require parity on writes to be inhibited. 


-d Set or reset the density select bit (DSB) and set 
the density bits according to the following table. 


Spe 
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DSB must be set for drives that do not select 
density via the five standard tape interface 
command lines. 


Use density default 
Use density default 
Set low density mode 
Set high density mode 
Set 800 BPI; 


use with —1 option 
Set 1600 BPI; 

use with —m option 
Set 3200 BPI 

Set 6250 BPI; 

use with —h option 





-! Load the low density code [code so that the 
controller can select low density via the five 
standard tape interface command lines. 


—-m Load the medium density code mcode so that 
the controller can select medium density via the 
five standard tape interface command lines. 

—h Load the high density code heode so that the 
controller can select high density via the five 
standard tape interface command lines. 

~£ Enable the 772 to write variable length 
interrecord gaps by setting the variable record 
gap code to gcode. 

-8 Set the drive speed to low or high. 


~x Set the interrecord gap to extended or default. 


DENSITY AND GAP SELECTION CODES 
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The 772 uses the following bits to select the density of a 
particular tape drive via the five standard tape interface 
command lines. 


7 6 5 4 3 2 1 0 
Igap thr1 hsp erase wfm edit write reverse 


The associated codes are given in the table below for 
some of the tape drives currently on the market. 
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800 1600 

lcode __ mcode 

Cipher F880 0 
Cipher F890 Oxlc 
Cipher M990 Oxl1c 


CDC 92181 0 
CDC 92185 Oxle 


Fujitsu 2242 Oxlc 


Kennedy 9400* 0 
Kennedy 9600 Oxlc 


Pertec FS1000 # 
Pertec FS2000 *% 


STC 2920 Oxic 
Telex Shamrock 


Thorn 9800*** 
Thorn 9900 


*% Defaults to 1600 at BOT. 





6250 Gap 
heode _gcode 
0 
0 
0x03 


0 0 
Oxld 0x82 


Ox1d 0 


Selects density via interface pin P2-50. 


art Selects density via interface pin P1-36. 


EXAMPLES 


To print the current configuration of drive 0: 


xmset -p /dev/rmt/cld0c 


To set the drive parameters of drive 1 for a Cipher M990 
tape drive and to print the resulting configuration: 


xmset -t M990 -p /dev/rmt/cldle 


To set the density select bit, the density selection and 
variable gap codes of drive 2 for a CDC 92185 and to 


print the resulting configuration: 


xmset -d 5 -10 -m Oxle -h Oxld -g 0x82 -p /dev/rmt/cld2c 


FILES 
/dev/rmt/cldne 


SEE ALSO 
Iddrv(1M). 


MightyFrame VME Half-Inch Tape 


Manual. 
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NAME 


XSTR(1) 


xstr ~ extract and share strings in C programs 


SYNOPSIS 


xstr —c source 


xstr 


xstr source 


DESCRIPTION 


Xetr creates a version of a C program in which all strings 
are contained in a single external array, xstr. This 
optimizes the program in two ways: 


Redundant characters are removed from the 
object file. A string that is identical to a string 
earlier in the program is eliminated. A string 
that is a terminal substring of a longer string is 
also eliminated, but only if zstr sees the longer 
string first. 


The zstr array can be made read-only (shared), 
reducing space and swapping. 


Compiling and linking a program with zsir requires three 
changes in the usual procedure: 


1. 


Instead of compiling the source files, pass each 
source file to zatr with the —e option (see first 
synopsis above). This produces a file z.¢ which 
is compiled in place of source. 


X.¢e contains the same code as source but with 
each string replaced by an expression of the form 
(&xstr[number}), where number is the 
appropriate offset in xstr. Xsitr also creates or 
updates the file strings in the current directory 
to include strings encountered in source. 


Source can be a —, indicating standard input. 
This is useful when the C preprocessor produces 
or suppresses strings. The command to use the 
preprocessor with zstr takes the form 


ce —E source | xstr —c — 


Run zstr without parameters (second synopsis 
above). Xsir uses strings to create zs.c, a file 
that declares the xstr array. Compile xs.c. 


Link the object file compiled from zs.¢ (normally 
called zs.0) together with all the object files 
produced in step 1. 
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Strings is only touched when a string is added or 
removed. Thus make(1) can speed things up by making 
zs.o dependent on strings. 


If a program has a single source file, pass it to zstr 
without the —e option (third synopsis above). This 
creates z.c and 2z8.c without touching strings. 


EXAMPLE 


FILES 


The following makefile uses zstr to produce a program 
from three source files: main.c, uno.c, and omega.c. 


a.out: main.o uno.o omega.o xs.0 
cc main.o uno.o omega.o xs.0 


xs.o: strings 
xstr 
cc -C XS.c 


.C.0: 
ce -E $*.c¢ | xstr -c - 
ce -¢ X.c 
mv x.0 $*.0 


strings strings found in source 
X.C massaged C source 
xS.C definition of xstr array 
/tmp/xs* Temp file 
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NAME 

yace — yet another compiler-compiler 
SYNOPSIS 

yace { —vdlt | grammar 
DESCRIPTION 


FILES 


Yace converts a context-free grammar into a set of 
tables for a simple automaton which executes an LR(1) 
parsing algorithm. The grammar may be ambiguous; 
specified precedence rules are used to break ambiguities. 


The output file, y.tab.c, must be compiled by the C 
compiler to produce a program yyparse. This program 
must be loaded with the lexical analyzer program, yylez, 
as well as main and yyerror, an error handling routine. 
These routines must be supplied by the user; /ez(1) is 
useful for creating lexical analyzers usable by yacc. 


If the —v flag is given, the file y.output is prepared, 
which contains a description of the parsing tables and a 
report on conflicts generated by ambiguities in the 
grammar. 


If the —d flag is used, the file y.tab.h is generated with 
the #define statements that associate the yacc-assigned 
“token codes” with the user-declared “token names’’. 
This allows source files other than y.tab.ec to access the 
token codes. 


If the —] flag is given, the code produced in y.tab.e will 
not contain any #line constructs. This should only be 
used after the grammar and the associated actions are 
fully debugged. 


Runtime debugging code is always generated in y.tab.c 
under conditional compilation control. By default, this 
code is not included when y.tab.e is compiled. 
However, when yacc’s —t option is used, this debugging 
code will be compiled by default. Independent of 
whether the —t option was used, the runtime debugging 
code is under the control of YYDEBUG, a pre-processor 
symbol. If YYDEBUG has a non-zero value, then the 
debugging code is included. If its value is zero, then the 
code will not be included. The size and execution time 
of a program produced without the runtime debugging 
code will be smaller and slightly faster. 


y.output 

y.tab.c 

y.tab.h defines for token names 
yacc.tmp, 
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yacc.debug, yacc.acts temporary files 
/usr/lib/yaecpar parser prototype for C programs 


SEE ca 


text) malloc(3X). 
L Po 's Guide, Section 18. 


DIAGNOSTICS 


BUGS 


The number of reduce-reduce and shift-reduce conflicts is 
reported on the standard error output; a more detailed 
report is found in the y.output file. Similarly, if some 
rules are not reachable from the start symbol, this is also 
reported. 


Because file names are fixed, at most one yace process 
can be active in a given directory at a time. 


